Welcome to Acton
Acton is an all-in-one TON smart contract development toolkit
Acton is an all-in-one TON smart contract development toolkit written in Rust. It combines project scaffolding, build, testing, scripting, wallet and network operations, verification, linting, formatting, and low-level VM tooling in one CLI.
New to Acton? Start with Installation, then follow
the Quickstart. If you already have a repository, start
with acton init and the Project initialization
guide instead of creating a new scaffold.
What you can do with Acton
- Create a new Tolk project from a ready-made template.
- Build contracts, run tests, and script interactions from one CLI.
- Manage wallets, deploy to the network, and verify published contracts.
- Work locally with a TON-compatible development node, faucet, snapshots, and forked state.
Start here
Installation
Install Acton and verify that the binary is available in your shell.
Quickstart
Build, test, deploy, and verify your first Tolk smart contract.
Project initialization
Choose between acton new for fresh scaffolds and acton init for
existing repositories.
First production workflow
Test Runner
Write unit and integration tests in Tolk, inspect traces, and measure coverage.
Wallet setup
Create local or global wallets and prepare them for deployment workflows.
Contract deployment
Deploy compiled contracts through scripts and understand the required inputs.
Contract verification
Verify that deployed bytecode matches your source code.
Go deeper
Commands reference
Browse all Acton CLI commands, flags, and related workflows.
Build system
Understand contract configuration, dependency handling, and build outputs.
Scripting
Run standalone Tolk scripts for deployment, automation, and blockchain interaction.
Local development node
Use a local node with faucet, persistence, snapshots, and fork mode.
Linting
Check Tolk code, configure rules, and integrate checks into CI.
Standard library
Explore the built-in Acton and Tolk libraries available in your projects.
Recommended reading order
Start with Installation and make sure
acton --version works in a fresh shell.
Use Project initialization to decide whether you
should run acton new or acton init. Existing repositories do not
need to be recreated from a template.
Follow the Quickstart and the Test Runner docs to get a reliable local feedback loop first.
Set up wallets, then use the deployment and scripting guides when you are ready to send messages or publish contracts.
Once the basics are working, read the build system, linting, and CI sections to make the project reproducible for a team or pipeline.
Need something specific?
- Want the shortest path to a running project? Go to Quickstart.
- Looking for command syntax? Open Commands.
- Need help reading CLI help? Use
acton --helpfor the overview,acton help <command>for the long manual, and<nested> --helpfor exact nested subcommand help such asacton wallet list --help. - Working on tests? Start with Test Runner.
- Need environment and dependency details? Read Acton.toml and Build system.
- If setup or path resolution looks wrong, run
acton doctor.
Last updated on