Skip to content

Latest commit

 

History

History
129 lines (100 loc) · 6.26 KB

README.md

File metadata and controls

129 lines (100 loc) · 6.26 KB

Проект симулятора Ethereum Virtual Machine

Начальная настройка проекта

Инструкции для Linux

Для начала работы после клонирования проекта требуется единожды запустить скрипт (ВНИМАНИЕ, требуется ввести пароль от sudo):

./first-start

будет выполнено подключение необходимых модулей, а также установлены необходимые пакеты для сборки и работы симуляторов go-ethereum, cemu и qemu.

Инструкции для Windows

Для начала работы после клонирования проекта требуется:

  1. Установить среду Cygwin, а также необходимые пакеты для сборки проекта:
  • autoconf
  • automake
  • libmpc-devel
  • libmpfr-devel
  • libgmp-devel
  • gawk
  • bison
  • flex
  • texinfo
  • patchutils
  • gcc-core
  • gcc-g++
  • zlib-devel
  • libexpat-devel
  • make
  • libintl-devel
  • python2
  • mingw64-x86_64-gcc-g++
  • mingw64-x86_64-gcc-core
  • mingw64-x86_64-glib2.0
  • mingw64-x86_64-pixman
  • mingw64-x86_64-pkg-config
  • mingw64-x86_64-curl
  • mingw64-x86_64-gtk3
  • mingw64-x86_64-libssh2
  • mingw64-x86_64-libtasn1
  • mingw64-x86_64-nettle
  • mingw64-x86_64-ncurses
  • mingw64-x86_64-gnutls

  1. Установить solidity compiler для Windows, а также пакет Microsoft Visual C++ 2015 Redistributable. После распаковки архива с компилятором в нужное место (напр., С:\solc) добавить путь в переменную окружения PATH.

  2. Установить MS Visual Studio (рекомендуется MS Visual Studio 2017), необходимую для сборки cemu и его библиотек

  3. Загрузить и собрать SystemC (строго рекомендуется версия 2.3.2). Для сборки использовать MS Visual Studio. Каталог SystemC расположить по пути C:\systemc-2.3.2.

Примечание: для использования библиотеки evm (QEMU/qemu/ppdl-softmmu/libevm-ppdl.dll) и симулятора (QEMU/qemu/ppdl-softmmu/qemu-system-ppdl.exe) под Windows необходимо добавить путь к библиотекам MinGW к переменной PATH (напр., C:\cygwin64\usr\x86_64-w64-wingw32\sys-root\mingw\bin).

Примечание: при использовании gVm1 из Visual Studio вышеуказанные манипуляции с PATH проделывать необязательно.

Сборка проекта

  • Для сборки проекта необходимо выполнить:
./build-all

будут собраны симуляторы go-ethereum (только Linux), cemu (только Linux) и qemu, а также тесты системы тестирования.

Примечание: для сборки CEMU под Windows используется MS Visual Studio (C:\Users\alex\Desktop\kant1-pvmcore\emulator\models\evm\simulator\VC14\simulator.sln)

Индикацией успешной сборки является наличие:

  • Linux:
    1. бинарных файлов симуляторов:
      • ethereum/build/bin/evm
      • emulator/bins/cemu
      • QEMU/qemu/ppdl-softmmu/qemu-system-ppdl
    2. библиотек архитектуры:
      • emulator/models/evm/simulator/evm.so
      • QEMU/qemu/ppdl-softmmu/libevm-ppdl.so
    3. бинарных файлов тестов:
      • tests/asm/test_name/test_name.bin
  • Windows:
    1. бинарных файлов симуляторов:
      • emulator/bins/cemu.exe
      • QEMU/qemu/ppdl-softmmu/qemu-system-ppdl.exe
    2. библиотек архитектуры:
      • emulator/models/evm/simulator/bins/evm.dll
      • QEMU/qemu/ppdl-softmmu/libevm-ppdl.dll
    3. бинарных файлов тестов:
      • tests/asm/test_name/test_name.bin

Примечание: в Windows выполнение любых команд необходимо производить из терминала Cygwin.

Тестирование

Запуск полного тестирования со сравнением

Для запуска тестов необходимо перейти в каталог tests/asm/ и выполнить одну из команд:

make compare
make test-cemu
make test-qemu

Система запустит поочередно каждый тест в двух симуляторах, сравнит выходные данные и выдаст результат теста:

  • make compare запускает сравнение QEMU vs CEMU
  • make test-cemu запускает сравнение CEMU vs EVM (только Linux)
  • make test-qemu запускает сравнение QEMU vs EVM (только Linux)

По завершении тестирования будет дана сводка по количеству пройденных тестов в формате:

Test Result Summary:
    PASS: XXX
    FAIL: YYY

Запуск отдельных тестов на симуляторе

Можно проводить запуск конкретных тестов на каком-либо симуляторе. Для этого необходимо перейти в каталог теста (напр., tests/asm/add/) и выполнить одну из команд:

make run-qemu
make run-cemu
make run-evm (только Linux)

Будет произведен запуск теста на соответствующем симуляторе и показан результат работы. Примечание: опции запуска симуляторов описаны в файле tests/asm/Makefile.in в соответствующих секциях.