Acton
Testing

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