mirror of
https://github.com/ton-blockchain/ton
synced 2025-02-12 11:12:16 +00:00
33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
|
# 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.
|