/* 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 . */ /** * @author Christian * @date 2014 * Solidity abstract syntax tree. */ #include #include #include #include #include #include #include using namespace std; using namespace dev; using namespace dev::solidity; class IDDispenser { public: static size_t next() { return ++instance(); } static void reset() { instance() = 0; } private: static size_t& instance() { static IDDispenser dispenser; return dispenser.id; } size_t id = 0; }; ASTNode::ASTNode(SourceLocation const& _location): m_id(IDDispenser::next()), m_location(_location) { } ASTNode::~ASTNode() { delete m_annotation; } void ASTNode::resetID() { IDDispenser::reset(); } ASTAnnotation& ASTNode::annotation() const { if (!m_annotation) m_annotation = new ASTAnnotation(); return *m_annotation; } SourceUnitAnnotation& SourceUnit::annotation() const { if (!m_annotation) m_annotation = new SourceUnitAnnotation(); return dynamic_cast(*m_annotation); } set SourceUnit::referencedSourceUnits(bool _recurse, set _skipList) const { set sourceUnits; for (ImportDirective const* importDirective: filteredNodes(nodes())) { auto const& sourceUnit = importDirective->annotation().sourceUnit; if (!_skipList.count(sourceUnit)) { _skipList.insert(sourceUnit); sourceUnits.insert(sourceUnit); if (_recurse) sourceUnits += sourceUnit->referencedSourceUnits(true, _skipList); } } return sourceUnits; } ImportAnnotation& ImportDirective::annotation() const { if (!m_annotation) m_annotation = new ImportAnnotation(); return dynamic_cast(*m_annotation); } TypePointer ImportDirective::type() const { solAssert(!!annotation().sourceUnit, ""); return make_shared(*annotation().sourceUnit); } map, FunctionTypePointer> ContractDefinition::interfaceFunctions() const { auto exportedFunctionList = interfaceFunctionList(); map, FunctionTypePointer> exportedFunctions; for (auto const& it: exportedFunctionList) exportedFunctions.insert(it); solAssert( exportedFunctionList.size() == exportedFunctions.size(), "Hash collision at Function Definition Hash calculation" ); return exportedFunctions; } FunctionDefinition const* ContractDefinition::constructor() const { for (FunctionDefinition const* f: definedFunctions()) if (f->isConstructor()) return f; return nullptr; } bool ContractDefinition::constructorIsPublic() const { FunctionDefinition const* f = constructor(); return !f || f->isPublic(); } FunctionDefinition const* ContractDefinition::fallbackFunction() const { for (ContractDefinition const* contract: annotation().linearizedBaseContracts) for (FunctionDefinition const* f: contract->definedFunctions()) if (f->isFallback()) return f; return nullptr; } vector const& ContractDefinition::interfaceEvents() const { if (!m_interfaceEvents) { set eventsSeen; m_interfaceEvents.reset(new vector()); for (ContractDefinition const* contract: annotation().linearizedBaseContracts) for (EventDefinition const* e: contract->events()) { /// NOTE: this requires the "internal" version of an Event, /// though here internal strictly refers to visibility, /// and not to function encoding (jump vs. call) auto const& function = e->functionType(true); solAssert(function, ""); string eventSignature = function->externalSignature(); if (eventsSeen.count(eventSignature) == 0) { eventsSeen.insert(eventSignature); m_interfaceEvents->push_back(e); } } } return *m_interfaceEvents; } vector, FunctionTypePointer>> const& ContractDefinition::interfaceFunctionList() const { if (!m_interfaceFunctionList) { set signaturesSeen; m_interfaceFunctionList.reset(new vector, FunctionTypePointer>>()); for (ContractDefinition const* contract: annotation().linearizedBaseContracts) { vector functions; for (FunctionDefinition const* f: contract->definedFunctions()) if (f->isPartOfExternalInterface()) functions.push_back(make_shared(*f, false)); for (VariableDeclaration const* v: contract->stateVariables()) if (v->isPartOfExternalInterface()) functions.push_back(make_shared(*v)); for (FunctionTypePointer const& fun: functions) { if (!fun->interfaceFunctionType()) // Fails hopefully because we already registered the error continue; string functionSignature = fun->externalSignature(); if (signaturesSeen.count(functionSignature) == 0) { signaturesSeen.insert(functionSignature); FixedHash<4> hash(dev::keccak256(functionSignature)); m_interfaceFunctionList->push_back(make_pair(hash, fun)); } } } } return *m_interfaceFunctionList; } vector const& ContractDefinition::inheritableMembers() const { if (!m_inheritableMembers) { set memberSeen; m_inheritableMembers.reset(new vector()); auto addInheritableMember = [&](Declaration const* _decl) { solAssert(_decl, "addInheritableMember got a nullpointer."); if (memberSeen.count(_decl->name()) == 0 && _decl->isVisibleInDerivedContracts()) { memberSeen.insert(_decl->name()); m_inheritableMembers->push_back(_decl); } }; for (FunctionDefinition const* f: definedFunctions()) addInheritableMember(f); for (VariableDeclaration const* v: stateVariables()) addInheritableMember(v); for (StructDefinition const* s: definedStructs()) addInheritableMember(s); for (EnumDefinition const* e: definedEnums()) addInheritableMember(e); for (EventDefinition const* e: events()) addInheritableMember(e); } return *m_inheritableMembers; } TypePointer ContractDefinition::type() const { return make_shared(make_shared(*this)); } ContractDefinitionAnnotation& ContractDefinition::annotation() const { if (!m_annotation) m_annotation = new ContractDefinitionAnnotation(); return dynamic_cast(*m_annotation); } TypeNameAnnotation& TypeName::annotation() const { if (!m_annotation) m_annotation = new TypeNameAnnotation(); return dynamic_cast(*m_annotation); } TypePointer StructDefinition::type() const { return make_shared(make_shared(*this)); } TypeDeclarationAnnotation& StructDefinition::annotation() const { if (!m_annotation) m_annotation = new TypeDeclarationAnnotation(); return dynamic_cast(*m_annotation); } TypePointer EnumValue::type() const { auto parentDef = dynamic_cast(scope()); solAssert(parentDef, "Enclosing Scope of EnumValue was not set"); return make_shared(*parentDef); } TypePointer EnumDefinition::type() const { return make_shared(make_shared(*this)); } TypeDeclarationAnnotation& EnumDefinition::annotation() const { if (!m_annotation) m_annotation = new TypeDeclarationAnnotation(); return dynamic_cast(*m_annotation); } ContractDefinition::ContractKind FunctionDefinition::inContractKind() const { auto contractDef = dynamic_cast(scope()); solAssert(contractDef, "Enclosing Scope of FunctionDefinition was not set."); return contractDef->contractKind(); } FunctionTypePointer FunctionDefinition::functionType(bool _internal) const { if (_internal) { switch (visibility()) { case Declaration::Visibility::Default: solAssert(false, "visibility() should not return Default"); case Declaration::Visibility::Private: case Declaration::Visibility::Internal: case Declaration::Visibility::Public: return make_shared(*this, _internal); case Declaration::Visibility::External: return {}; } } else { switch (visibility()) { case Declaration::Visibility::Default: solAssert(false, "visibility() should not return Default"); case Declaration::Visibility::Private: case Declaration::Visibility::Internal: return {}; case Declaration::Visibility::Public: case Declaration::Visibility::External: return make_shared(*this, _internal); } } // To make the compiler happy return {}; } TypePointer FunctionDefinition::type() const { solAssert(visibility() != Declaration::Visibility::External, ""); return make_shared(*this); } string FunctionDefinition::externalSignature() const { return FunctionType(*this).externalSignature(); } FunctionDefinitionAnnotation& FunctionDefinition::annotation() const { if (!m_annotation) m_annotation = new FunctionDefinitionAnnotation(); return dynamic_cast(*m_annotation); } TypePointer ModifierDefinition::type() const { return make_shared(*this); } ModifierDefinitionAnnotation& ModifierDefinition::annotation() const { if (!m_annotation) m_annotation = new ModifierDefinitionAnnotation(); return dynamic_cast(*m_annotation); } TypePointer EventDefinition::type() const { return make_shared(*this); } FunctionTypePointer EventDefinition::functionType(bool _internal) const { if (_internal) return make_shared(*this); else return {}; } EventDefinitionAnnotation& EventDefinition::annotation() const { if (!m_annotation) m_annotation = new EventDefinitionAnnotation(); return dynamic_cast(*m_annotation); } UserDefinedTypeNameAnnotation& UserDefinedTypeName::annotation() const { if (!m_annotation) m_annotation = new UserDefinedTypeNameAnnotation(); return dynamic_cast(*m_annotation); } SourceUnit const& Scopable::sourceUnit() const { ASTNode const* s = scope(); solAssert(s, ""); // will not always be a declaration while (dynamic_cast(s) && dynamic_cast(s)->scope()) s = dynamic_cast(s)->scope(); return dynamic_cast(*s); } string Scopable::sourceUnitName() const { return sourceUnit().annotation().path; } bool VariableDeclaration::isLValue() const { // External function parameters and constant declared variables are Read-Only return !isExternalCallableParameter() && !m_isConstant; } bool VariableDeclaration::isLocalVariable() const { auto s = scope(); return dynamic_cast(s) || dynamic_cast(s) || dynamic_cast(s) || dynamic_cast(s); } bool VariableDeclaration::isCallableParameter() const { if (isReturnParameter()) return true; vector> const* parameters = nullptr; if (auto const* funTypeName = dynamic_cast(scope())) parameters = &funTypeName->parameterTypes(); else if (auto const* callable = dynamic_cast(scope())) parameters = &callable->parameters(); if (parameters) for (auto const& variable: *parameters) if (variable.get() == this) return true; return false; } bool VariableDeclaration::isLocalOrReturn() const { return isReturnParameter() || (isLocalVariable() && !isCallableParameter()); } bool VariableDeclaration::isReturnParameter() const { vector> const* returnParameters = nullptr; if (auto const* funTypeName = dynamic_cast(scope())) returnParameters = &funTypeName->returnParameterTypes(); else if (auto const* callable = dynamic_cast(scope())) if (callable->returnParameterList()) returnParameters = &callable->returnParameterList()->parameters(); if (returnParameters) for (auto const& variable: *returnParameters) if (variable.get() == this) return true; return false; } bool VariableDeclaration::isExternalCallableParameter() const { if (!isCallableParameter()) return false; if (auto const* callable = dynamic_cast(scope())) if (callable->visibility() == Declaration::Visibility::External) return !isReturnParameter(); return false; } bool VariableDeclaration::isInternalCallableParameter() const { if (!isCallableParameter()) return false; if (auto const* funTypeName = dynamic_cast(scope())) return funTypeName->visibility() == Declaration::Visibility::Internal; else if (auto const* callable = dynamic_cast(scope())) return callable->visibility() <= Declaration::Visibility::Internal; return false; } bool VariableDeclaration::isLibraryFunctionParameter() const { if (!isCallableParameter()) return false; if (auto const* funDef = dynamic_cast(scope())) return dynamic_cast(*funDef->scope()).isLibrary(); else return false; } bool VariableDeclaration::isEventParameter() const { return dynamic_cast(scope()) != nullptr; } bool VariableDeclaration::hasReferenceOrMappingType() const { solAssert(typeName(), ""); solAssert(typeName()->annotation().type, "Can only be called after reference resolution"); TypePointer const& type = typeName()->annotation().type; return type->category() == Type::Category::Mapping || dynamic_cast(type.get()); } set VariableDeclaration::allowedDataLocations() const { using Location = VariableDeclaration::Location; if (!hasReferenceOrMappingType() || isStateVariable() || isEventParameter()) return set{ Location::Unspecified }; else if (isStateVariable() && isConstant()) return set{ Location::Memory }; else if (isExternalCallableParameter()) { set locations{ Location::CallData }; if (isLibraryFunctionParameter()) locations.insert(Location::Storage); return locations; } else if (isCallableParameter()) { set locations{ Location::Memory }; if (isInternalCallableParameter() || isLibraryFunctionParameter()) locations.insert(Location::Storage); return locations; } else if (isLocalVariable()) { solAssert(typeName(), ""); solAssert(typeName()->annotation().type, "Can only be called after reference resolution"); if (typeName()->annotation().type->category() == Type::Category::Mapping) return set{ Location::Storage }; else // TODO: add Location::Calldata once implemented for local variables. return set{ Location::Memory, Location::Storage }; } else // Struct members etc. return set{ Location::Unspecified }; } TypePointer VariableDeclaration::type() const { return annotation().type; } FunctionTypePointer VariableDeclaration::functionType(bool _internal) const { if (_internal) return {}; switch (visibility()) { case Declaration::Visibility::Default: solAssert(false, "visibility() should not return Default"); case Declaration::Visibility::Private: case Declaration::Visibility::Internal: return {}; case Declaration::Visibility::Public: case Declaration::Visibility::External: return make_shared(*this); } // To make the compiler happy return {}; } VariableDeclarationAnnotation& VariableDeclaration::annotation() const { if (!m_annotation) m_annotation = new VariableDeclarationAnnotation(); return dynamic_cast(*m_annotation); } StatementAnnotation& Statement::annotation() const { if (!m_annotation) m_annotation = new StatementAnnotation(); return dynamic_cast(*m_annotation); } InlineAssemblyAnnotation& InlineAssembly::annotation() const { if (!m_annotation) m_annotation = new InlineAssemblyAnnotation(); return dynamic_cast(*m_annotation); } ReturnAnnotation& Return::annotation() const { if (!m_annotation) m_annotation = new ReturnAnnotation(); return dynamic_cast(*m_annotation); } ExpressionAnnotation& Expression::annotation() const { if (!m_annotation) m_annotation = new ExpressionAnnotation(); return dynamic_cast(*m_annotation); } MemberAccessAnnotation& MemberAccess::annotation() const { if (!m_annotation) m_annotation = new MemberAccessAnnotation(); return dynamic_cast(*m_annotation); } BinaryOperationAnnotation& BinaryOperation::annotation() const { if (!m_annotation) m_annotation = new BinaryOperationAnnotation(); return dynamic_cast(*m_annotation); } FunctionCallAnnotation& FunctionCall::annotation() const { if (!m_annotation) m_annotation = new FunctionCallAnnotation(); return dynamic_cast(*m_annotation); } IdentifierAnnotation& Identifier::annotation() const { if (!m_annotation) m_annotation = new IdentifierAnnotation(); return dynamic_cast(*m_annotation); } ASTString Literal::valueWithoutUnderscores() const { return boost::erase_all_copy(value(), "_"); } bool Literal::isHexNumber() const { if (token() != Token::Number) return false; return boost::starts_with(value(), "0x"); } bool Literal::looksLikeAddress() const { if (subDenomination() != SubDenomination::None) return false; if (!isHexNumber()) return false; return abs(int(valueWithoutUnderscores().length()) - 42) <= 1; } bool Literal::passesAddressChecksum() const { solAssert(isHexNumber(), "Expected hex number"); return dev::passesAddressChecksum(valueWithoutUnderscores(), true); } string Literal::getChecksummedAddress() const { solAssert(isHexNumber(), "Expected hex number"); /// Pad literal to be a proper hex address. string address = valueWithoutUnderscores().substr(2); if (address.length() > 40) return string(); address.insert(address.begin(), 40 - address.size(), '0'); return dev::getChecksummedAddress(address); }