Acton is the all-in-one development toolkit for TON smart contracts. Written in Rust for native speed, it ships as a single, dependency-free binary that covers the entire contract lifecycle — from scaffolding a new project withDocumentation 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 new all the way to deploying and verifying on mainnet — without reaching for separate tools or language runtimes. Whether you are writing your first Tolk contract or maintaining a production dApp, every workflow runs through one familiar CLI.
Why Acton
TON contract development historically required assembling several independent tools: a compiler, a test harness, a wallet manager, a linter, a deployment helper, and more. Acton replaces that patchwork with a single, cohesive experience that is optimised for both human developers and AI coding agents.Single CLI
One command covers create, build, test, debug, deploy, and verify. No glue scripts required.
Native Rust Speed
The build system and test runtime are implemented in Rust, keeping compile and test cycles fast.
Tolk-First Workflow
Built-in wrappers, testing utilities, and deployment scripts are all written in Tolk, the first-class language for TON contracts.
dApp Scaffolding
The
--app flag adds a Vite/React frontend scaffold and auto-generated TypeScript wrappers so contracts and the frontend always stay in sync.Advanced Test Runner
Fork-mode tests, gas snapshots, coverage reporting, mutation testing, fuzz testing, and an interactive browser Test UI are all built in.
Built-in Localnet
acton localnet spins up a local TON node for offline development and forks live network state on demand.Linter with 25+ Rules
acton check enforces correctness and style rules across your Tolk sources, with auto-fix support and CI-friendly output formats.Wallet Management
Create, import, fund, and sign with local or global wallets directly from the CLI — no external wallet app needed during development.
DAP Debugger
The built-in Debug Adapter Protocol debugger integrates with VS Code and JetBrains IDEs for source-level stepping through Tolk contracts.
On-Chain Libraries
Publish reusable Tolk code as masterchain library accounts and reference them from any number of deployed contracts.
Key features at a glance
| Feature | Command |
|---|---|
| Scaffold a project | acton new <name> --template counter |
| Compile contracts | acton build |
| Run the test suite | acton test |
| Lint Tolk sources | acton check |
| Format Tolk files | acton fmt |
| Deploy via script | acton script contracts/scripts/deploy.tolk --net testnet |
| Verify on-chain | acton verify Counter --net testnet --address <ADDR> |
| Manage wallets | acton wallet new --name deployer --local --airdrop --version v5r1 |
| Start local node | acton localnet start |
| Update the CLI | acton up |
Start here
Installation
Install Acton on macOS, Linux, or WSL in one command and verify the binary is on your
PATH.Quickstart
Scaffold a counter project from the built-in template, run tests, and open the dApp frontend in under five minutes.
Walkthrough
A guided tour through the full development cycle: build, lint, test with coverage and mutation, deploy, and verify.
Using the CLI
Runacton --help for a command overview, acton help <command> for the detailed manual of a specific command, and acton <nested> --help for nested subcommands.