Overview
Learn how to write and run tests for Tolk smart contracts
This section contains guides and reference documentation for Acton's test runner.
Generating Wrappers
Learn how to automatically generate wrappers for Tolk contracts
Test Attributes
Learn how to use test attributes to control test behavior, skip tests, and set expectations
Fuzz Testing
Learn how to run parameterized tests with generated inputs, assumptions, and bounds
Test Configuration
Learn how to configure test runner behavior through project settings and command line options
World State Snapshots
Learn how to save and restore local emulation state as JSON fixtures inside tests
Step-by-step Execution
Learn how to use testing.createTraceIterationCursor() and TxCursor to execute transaction chains in parts
Test UI
Learn how to inspect traces, transaction trees, logs, and failures in the browser UI
Saved Trace Bundles
Reference for the JSON artifacts written by acton test --save-test-trace and reused by the Test UI
Built-in Matchers and Helpers
Find transaction predicates, map expectations, and out-action helpers before writing your own matchers
Reading Transaction Chains
Learn how to read the text trace format printed by println(txs) and matcher failures
Gas Profiling with Snapshots
Learn how to profile opcode and transaction-chain gas/fee metrics, save snapshots, and compare with baselines
Fork Testing
Learn how to test contracts against real blockchain state by forking testnet or mainnet
Code Coverage
Learn how to measure and analyze code coverage in your Tolk smart contract tests
Mutation Testing
Learn how to use mutation testing to assess the quality of your test suite
Cookbook
Practical examples and code snippets for common testing scenarios in Tolk smart contracts
Custom Matchers
Learn how to add custom matchers for expect() calls
Last updated on