Emulation

Open in Swagger UI

The Emulation methods provide tools for predicting the outcomes of blockchain transactions before they are executed. These tools allow for simulating transactions, offering insights into their results, including an almost precise estimate of network fees (with a small margin of error due to limitations in fully emulating a contract’s internal state).

Possible use casesCopy Anchor Link

• Predicting transaction outcomes to verify correctness before execution.
• Estimating network fees for accurate cost calculation.
• Enabling services to display transaction results to end users in advance.

Implementation ExampleCopy Anchor Link

A detailed example of gasless transaction implementation is available in the Cookbook.

OperationsCopy Anchor Link

• decodeMessage — Decode a given message. Only external incoming messages can be decoded currently.
• emulateMessageToAccountEvent — Emulate sending message to retrieve account-specific events
• emulateMessageToEvent — Emulate sending message to retrieve general blockchain events
• emulateMessageToTrace — Emulate sending message to retrieve with a detailed execution trace
• emulateMessageToWallet — Emulates a wallet message on the current blockchain state and derives its consequences for the signing wallet