mirror of
https://github.com/ethereum/solidity
synced 2023-10-03 13:03:40 +00:00
83 lines
2.7 KiB
C++
83 lines
2.7 KiB
C++
/*
|
|
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/>.
|
|
*/
|
|
// SPDX-License-Identifier: GPL-3.0
|
|
/** @file Assembly.h
|
|
* @author Gav Wood <i@gavwood.com>
|
|
* @date 2014
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <libsolutil/Common.h>
|
|
#include <libsolutil/FixedHash.h>
|
|
|
|
namespace solidity::evmasm
|
|
{
|
|
|
|
/**
|
|
* Binary object that potentially still needs to be linked (i.e. addresses of other contracts
|
|
* need to be filled in).
|
|
*/
|
|
struct LinkerObject
|
|
{
|
|
/// The bytecode.
|
|
bytes bytecode;
|
|
|
|
/// Map from offsets in bytecode to library identifiers. The addresses starting at those offsets
|
|
/// need to be replaced by the actual addresses by the linker.
|
|
std::map<size_t, std::string> linkReferences;
|
|
|
|
/// Map from hashes of the identifiers of immutable variables to the full identifier of the immutable and
|
|
/// to a list of offsets into the bytecode that refer to their values.
|
|
std::map<u256, std::pair<std::string, std::vector<size_t>>> immutableReferences;
|
|
|
|
struct FunctionDebugData
|
|
{
|
|
std::optional<size_t> bytecodeOffset;
|
|
std::optional<size_t> instructionIndex;
|
|
std::optional<size_t> sourceID;
|
|
size_t params = {};
|
|
size_t returns = {};
|
|
};
|
|
|
|
/// Bytecode offsets of named tags like function entry points.
|
|
std::map<std::string, FunctionDebugData> functionDebugData;
|
|
|
|
/// Appends the bytecode of @a _other and incorporates its link references.
|
|
void append(LinkerObject const& _other);
|
|
|
|
/// Links the given libraries by replacing their uses in the code and removes them from the references.
|
|
void link(std::map<std::string, util::h160> const& _libraryAddresses);
|
|
|
|
/// @returns a hex representation of the bytecode of the given object, replacing unlinked
|
|
/// addresses by placeholders. This output is lowercase.
|
|
std::string toHex() const;
|
|
|
|
/// @returns a 36 character string that is used as a placeholder for the library
|
|
/// address (enclosed by `__` on both sides). The placeholder is the hex representation
|
|
/// of the first 18 bytes of the keccak-256 hash of @a _libraryName.
|
|
static std::string libraryPlaceholder(std::string const& _libraryName);
|
|
|
|
private:
|
|
static util::h160 const* matchLibrary(
|
|
std::string const& _linkRefName,
|
|
std::map<std::string, util::h160> const& _libraryAddresses
|
|
);
|
|
};
|
|
|
|
}
|