https://github.com/ton-blockchain/acton
Toolchain for TON smart contract development and beyond
https://github.com/ton-blockchain/acton
mtonga rust tolk ton ton-blockchain tooling
Last synced: 12 days ago
JSON representation
Toolchain for TON smart contract development and beyond
- Host: GitHub
- URL: https://github.com/ton-blockchain/acton
- Owner: ton-blockchain
- License: apache-2.0
- Created: 2025-10-17T16:52:07.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2026-05-14T16:00:25.000Z (20 days ago)
- Last Synced: 2026-05-14T16:22:31.166Z (20 days ago)
- Topics: mtonga, rust, tolk, ton, ton-blockchain, tooling
- Language: Rust
- Homepage: https://ton-blockchain.github.io/acton/
- Size: 61.2 MB
- Stars: 311
- Watchers: 8
- Forks: 38
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-APACHE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Acton
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, debugging, and low-level VM
tooling in one CLI.
Built for **humans**. Perfect for **AI**.
### [Read the docs →](https://ton-blockchain.github.io/acton/docs/welcome)
## Why Acton
- Single CLI for the full contract lifecycle: create, build, test, debug,
deploy, verify.
- Native speed (Rust-based toolchain and test runtime).
- Tolk-first workflow with built-in wrappers, testing utilities, and scripts.
- Ready for dApp development with project templates and automatically generated TypeScript wrappers.
- Fast test runner with fork mode, gas snapshots, coverage, mutation, fuzz testing, and the browser Test UI.
- Browser test UI for failed tests, traces, logs, and coverage inspection.
## Install
The recommended way to get Acton today is to run the latest public installer:
```bash
curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh
```
If you prefer a manual download, use the latest public release:
| Platform | Architecture | Download |
|----------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
| macOS | ARM64 | [acton-aarch64-apple-darwin.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-aarch64-apple-darwin.tar.gz) |
| macOS | x86_64 | [acton-x86_64-apple-darwin.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-x86_64-apple-darwin.tar.gz) |
| Linux | x86_64 | [acton-x86_64-unknown-linux-gnu.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-x86_64-unknown-linux-gnu.tar.gz) |
| Linux | ARM64 | [acton-aarch64-unknown-linux-gnu.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-aarch64-unknown-linux-gnu.tar.gz) |
After extracting the archive, make sure `acton` is on your `PATH` and verify
the installation:
```bash
acton --version
```
If you prefer a containerized workflow, use the published Docker image:
```bash
docker run --rm ghcr.io/ton-blockchain/acton: --version
```
To run Acton against the current project from Docker:
```bash
docker run --rm \
-v "$PWD":/workspace \
-w /workspace \
ghcr.io/ton-blockchain/acton: \
build
```
For more installation details, see the
[installation guide](https://ton-blockchain.github.io/acton/docs/installation).
## Support policy
Acton is stable on the latest numbered GitHub release. The first-class platform
matrix is macOS (ARM64, x86_64) plus Linux GNU (x86_64, ARM64). For Linux, the
documented baseline is Ubuntu 20.04 or newer. Native Windows is not supported
today. If you use Windows, run Acton inside WSL with Ubuntu 20.04 or newer and
follow the Linux installation path there. `trunk` builds installed via
`acton up --trunk`, WSL installs, and other source-built targets are beta /
best-effort surfaces for now. The full policy is documented at
[Support policy](https://ton-blockchain.github.io/acton/docs/installation#support-policy).
## From zero to testnet
```bash
# Create a new project from the built-in counter template
acton new first_counter --template counter
cd first_counter
# Build and test locally
acton build
acton test
# Create and fund a locally stored testnet wallet
acton wallet new --name deployer --local --airdrop --version v5r1
# Deploy to TON testnet
acton script scripts/deploy.tolk --net testnet
```
For a step-by-step walkthrough, see the
[quickstart guide](https://ton-blockchain.github.io/acton/docs/quickstart).
Already have a repository instead of starting from a template? The existing
project path is:
```bash
cd your-repo
acton init
acton build
acton test
```
For more details, see the [Project management guide](https://ton-blockchain.github.io/acton/docs/projects).
## Building from source
Source builds are intended for contributors and local development. See
[Building from source](CONTRIBUTING.md#building-from-source) in CONTRIBUTING.md.
## Contributing
Contributor setup, test workflows, UI build steps, and docs workflows are in
[CONTRIBUTING.md](CONTRIBUTING.md).
## License
Acton is licensed under either of
- Apache License, Version 2.0, ([LICENSE-APACHE](./LICENSE-APACHE) or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](./LICENSE-MIT) or https://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for
inclusion in Acton by you, as defined in the Apache-2.0 license, shall be dually licensed
as above, without any additional terms or conditions.