Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ton-blockchain/acton/llms.txt

Use this file to discover all available pages before exploring further.

Acton brings every tool you need for TON smart contract development into a single, fast CLI written in Rust. From scaffolding a new Tolk project to running mutation tests and deploying to mainnet, Acton handles the entire workflow with no plugin juggling or configuration ceremony.

Installation

Install Acton on macOS, Linux, or WSL in under a minute with the one-line installer.

Quickstart

Scaffold a counter project, build it, run tests, and start the dev UI in minutes.

Walkthrough

A guided tour through building, testing, deploying, and verifying a real contract.

Command Reference

Full reference for every Acton CLI command, subcommand, and flag.

Why Acton

Acton replaces a patchwork of separate tools — compiler, test runner, formatter, linter, deployer — with a single binary that understands the whole project.

Native Speed

Rust-based test runner and VM emulation. No JVM startup, no Node overhead.

Tolk-First

Built around the Tolk language with first-class wrappers, TypeScript codegen, and stdlib.

Full Lifecycle

Create → Build → Test → Debug → Deploy → Verify without leaving the terminal.

Test UI

Browser-based Test UI for inspecting transaction traces, coverage, and failures.

Local Network

Built-in localnet with faucet, fork mode, and SQLite-backed persistence.

CI Ready

JUnit XML, SARIF, GitHub Actions annotations, and GitLab Code Quality formats.

Get started in four steps

1

Install Acton

curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh
2

Create a project from a template

acton new first_counter --template counter
cd first_counter
3

Build and test

acton build
acton test
4

Deploy to testnet

acton wallet new --name deployer --local --airdrop --version v5r1
acton script scripts/deploy.tolk --net testnet

Explore by workflow

Projects & Scaffolding

Use templates, acton init, and project structure conventions.

Building Contracts

Compile Tolk sources, manage dependencies, and configure build output.

Testing

Unit tests, coverage, mutation testing, fuzz testing, and the browser Test UI.

Scripting & Deployment

Write and run Tolk scripts that interact with the blockchain.

Wallets

Create and manage testnet and mainnet wallets for deployment workflows.

Linting & Formatting

Catch bugs early with 25+ built-in linter rules and automatic Tolk formatting.

Build docs developers (and LLMs) love