external/ton
1
0
Fork 0
mirror of https://github.com/ton-blockchain/ton synced 2025-02-12 19:22:37 +00:00
Code Issues Releases Wiki Activity
ton/emulator
History
aleksej.paschenko d9580eab1b
Increase emulator capability to (de)serialize data (#811)
2023-11-23 14:01:45 +03:00
..
CMakeLists.txt Various changes in TVM, github builds and tests (#793) 2023-11-03 14:43:34 +03:00
emulator-emscripten.cpp Patch getmethod for tvm upgrade (#714) 2023-05-29 11:27:54 +03:00
emulator-extern.cpp Increase emulator capability to (de)serialize data (#811) 2023-11-23 14:01:45 +03:00
emulator-extern.h Fix returning config from LS, add extra c7 elements in getmethods (#713) 2023-05-27 21:22:31 +03:00
emulator_export_list Fix returning config from LS, add extra c7 elements in getmethods (#713) 2023-05-27 21:22:31 +03:00
README.md Add account state by transaction and emulator (extended) (#592) 2023-02-02 10:03:45 +03:00
StringLog.h Add account state by transaction and emulator (extended) (#592) 2023-02-02 10:03:45 +03:00
transaction-emulator.cpp Various changes in TVM, github builds and tests (#793) 2023-11-03 14:43:34 +03:00
transaction-emulator.h TVM Upgrade (#686) 2023-05-24 21:14:13 +03:00
tvm-emulator.hpp Fix returning config from LS, add extra c7 elements in getmethods (#713) 2023-05-27 21:22:31 +03:00

README.md

Emulator

Emulator is a shared library containing the following functionality:

  • Emulating blockchain transactions
  • Emulating TVM - get methods and sending external and internal messages.

Transaction Emulator

To emulate transaction you need the following data:

  • Account state of type ShardAccount.
  • Global config of type (Hashmap 32 ^Cell).
  • Inbound message of type MessageAny.

Optionally you can set emulation parameters:

  • ignore_chksig - whether CHKSIG instructions are set to always succeed. Default: false
  • lt - logical time of emulation. Default: next block's lt after the account's last transaction block.
  • unixtime - unix time of emulation. Default: current system time
  • rand_seed - random seed. Default: generated randomly
  • libs - shared libraries. If your smart contract uses shared libraries (located in masterchain), you should set this parameter.

Emulator output contains:

  • Transaction object (Transaction)
  • New account state (ShardAccount)
  • Actions cell (OutList n)
  • TVM log

TVM Emulator

TVM emulator is intended to run get methods or emulate sending message on TVM level. It is initialized with smart contract code and data cells.

  • To run get method you pass initial stack and method id (as integer).
  • To emulate sending message you pass message body and in case of internal message amount in nanograms.