mirror of
				https://github.com/ton-blockchain/ton
				synced 2025-03-09 15:40:10 +00:00 
			
		
		
		
	* 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>
		
			
				
	
	
		
			32 lines
		
	
	
	
		
			1.3 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			32 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.
 |