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/README.md
EmelyanenkoK 3b3c25b654
Add account state by transaction and emulator (extended) (#592) 
* account_state_by_transaction

* Correct time calculation

* Bug fixes

* Refactor

* namespace block::transaction

* smc.forget

* RunEmulator: remove wallet_id

* Refactor & fixes

* AccountStateByTransaction: use shardchain block instead of masterchain block

* transaction emulator core

* refactor

* tx emulator major functionality

* small format changes

* readme

* clean

* return json, add support for init messages

* tx emulator readme

* refactor getConfigParam and getConfigAll

* add shardchain_libs_boc parameter

* option to change verbosity level of transaction emulator

* fix deserializing ShardAccount with account_none

* add mode needSpecialSmc when unpack config

* emulator: block::Transaction -> block::transaction::Transaction

* Refactor

* emulator: Fix bug

* emulator: Support for emulator-extern

* emulator: Refactor

* Return vm log and vm exit code.

* fix build on macos, emulator_static added

* adjust documentation

* ignore_chksig for external messages

* tvm emulator, run get method

* Added more params for transaction emulator

* Added setters for optional transaction emulator params, moved libs to a new setter

* Added actions cell output to transaction emulator

* fix tonlib build

* refactoring, rand seed as hex size 64, tvm emulator send message

* tvm send message, small refactoring

* fix config decoding, rename

* improve documentation

* macos export symbols

* Added run_get_method to transaction emulator emscipten wrapper

* Fixed empty action list serialization

* Changed actions list cell to serialize as json null instead of empty string in transaction emulator

* stack as boc

* log gas remaining

* Fix prev_block_id

* fix build errors

* Refactor fetch_config_params

* fix failing unwrap of optional rand_seed

* lookup correct shard, choose prev_block based on account shard

* fix tonlib android jni build

---------

Co-authored-by: legaii <jgates.ardux@gmail.com>
Co-authored-by: ms <dungeon666master@protonmail.com>
Co-authored-by: krigga <krigga7@gmail.com>
2023-02-02 10:03:45 +03:00

1.3 KiB
Raw Permalink Blame History

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.