MessageCallProcessor.java

/*
 * Copyright ConsenSys AG.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 * specific language governing permissions and limitations under the License.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
package org.hyperledger.besu.evm.processor;

import org.hyperledger.besu.datatypes.Address;
import org.hyperledger.besu.datatypes.Wei;
import org.hyperledger.besu.evm.EVM;
import org.hyperledger.besu.evm.ModificationNotAllowedException;
import org.hyperledger.besu.evm.account.MutableAccount;
import org.hyperledger.besu.evm.frame.ExceptionalHaltReason;
import org.hyperledger.besu.evm.frame.MessageFrame;
import org.hyperledger.besu.evm.precompile.PrecompileContractRegistry;
import org.hyperledger.besu.evm.precompile.PrecompiledContract;
import org.hyperledger.besu.evm.tracing.OperationTracer;

import java.util.Collection;
import java.util.Objects;
import java.util.Optional;
import java.util.Set;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/** The Message call processor. */
public class MessageCallProcessor extends AbstractMessageProcessor {
  private static final Logger LOG = LoggerFactory.getLogger(MessageCallProcessor.class);

  private final PrecompileContractRegistry precompiles;

  /**
   * Instantiates a new Message call processor.
   *
   * @param evm the evm
   * @param precompiles the precompiles
   * @param forceCommitAddresses the force commit addresses
   */
  public MessageCallProcessor(
      final EVM evm,
      final PrecompileContractRegistry precompiles,
      final Collection<Address> forceCommitAddresses) {
    super(evm, forceCommitAddresses);
    this.precompiles = precompiles;
  }

  /**
   * Instantiates a new Message call processor.
   *
   * @param evm the evm
   * @param precompiles the precompiles
   */
  public MessageCallProcessor(final EVM evm, final PrecompileContractRegistry precompiles) {
    super(evm, Set.of());
    this.precompiles = precompiles;
  }

  @Override
  public void start(final MessageFrame frame, final OperationTracer operationTracer) {
    LOG.trace("Executing message-call");
    try {
      transferValue(frame);

      // Check first if the message call is to a pre-compile contract
      final PrecompiledContract precompile = precompiles.get(frame.getContractAddress());
      if (precompile != null) {
        executePrecompile(precompile, frame, operationTracer);
      } else {
        frame.setState(MessageFrame.State.CODE_EXECUTING);
      }
    } catch (final ModificationNotAllowedException ex) {
      LOG.trace("Message call error: attempt to mutate an immutable account");
      frame.setExceptionalHaltReason(Optional.of(ExceptionalHaltReason.ILLEGAL_STATE_CHANGE));
      frame.setState(MessageFrame.State.EXCEPTIONAL_HALT);
    }
  }

  @Override
  protected void codeSuccess(final MessageFrame frame, final OperationTracer operationTracer) {
    LOG.trace(
        "Successful message call of {} to {} (Gas remaining: {})",
        frame.getSenderAddress(),
        frame.getRecipientAddress(),
        frame.getRemainingGas());
    frame.setState(MessageFrame.State.COMPLETED_SUCCESS);
  }

  /**
   * Transfers the message call value from the sender to the recipient.
   *
   * <p>Assumes that the transaction has been validated so that the sender has the required fund as
   * of the world state of this executor.
   */
  private void transferValue(final MessageFrame frame) {
    final MutableAccount senderAccount = frame.getWorldUpdater().getSenderAccount(frame);

    // The yellow paper explicitly states that if the recipient account doesn't exist at this
    // point, it is created. Even if the value is zero we are still creating an account with 0x!
    final MutableAccount recipientAccount =
        frame.getWorldUpdater().getOrCreate(frame.getRecipientAddress());

    if (Objects.equals(frame.getValue(), Wei.ZERO)) {
      // This is only here for situations where you are calling a public address from a private
      // address. Without this guard clause we would attempt to get a mutable public address
      // which isn't possible from a private address and an error would be thrown.
      // If you are attempting to transfer value from a private address
      // to public address an error will be thrown.
      LOG.trace(
          "Message call from {} to {} has zero value: no fund transferred",
          frame.getSenderAddress(),
          frame.getRecipientAddress());
      return;
    }

    if (frame.getRecipientAddress().equals(frame.getSenderAddress())) {
      LOG.trace("Message call of {} to itself: no fund transferred", frame.getSenderAddress());
    } else {
      final Wei prevSenderBalance = senderAccount.decrementBalance(frame.getValue());
      final Wei prevRecipientBalance = recipientAccount.incrementBalance(frame.getValue());

      LOG.trace(
          "Transferred value {} for message call from {} ({} -> {}) to {} ({} -> {})",
          frame.getValue(),
          frame.getSenderAddress(),
          prevSenderBalance,
          senderAccount.getBalance(),
          frame.getRecipientAddress(),
          prevRecipientBalance,
          recipientAccount.getBalance());
    }
  }

  /**
   * Executes this message call knowing that it is a call to the provided pre-compiled contract.
   *
   * @param contract The contract this is a message call to.
   */
  private void executePrecompile(
      final PrecompiledContract contract,
      final MessageFrame frame,
      final OperationTracer operationTracer) {
    final long gasRequirement = contract.gasRequirement(frame.getInputData());
    if (frame.getRemainingGas() < gasRequirement) {
      frame.setExceptionalHaltReason(Optional.of(ExceptionalHaltReason.INSUFFICIENT_GAS));
      frame.setState(MessageFrame.State.EXCEPTIONAL_HALT);
    } else {
      frame.decrementRemainingGas(gasRequirement);
      final PrecompiledContract.PrecompileContractResult result =
          contract.computePrecompile(frame.getInputData(), frame);
      operationTracer.tracePrecompileCall(frame, gasRequirement, result.getOutput());
      if (result.isRefundGas()) {
        frame.incrementRemainingGas(gasRequirement);
      }
      if (frame.getState() == MessageFrame.State.REVERT) {
        frame.setRevertReason(result.getOutput());
      } else {
        frame.setOutputData(result.getOutput());
      }
      frame.setState(result.getState());
      frame.setExceptionalHaltReason(result.getHaltReason());
    }
  }
}