Reference TON contracts

Reference-grade TON contracts in Tolk, built with the Acton toolchain.

This monorepo collects reference implementations for core TON ecosystem contracts, built on the modern Tolk and Acton stack. Each contract system preserves interface compatibility with its original FunC implementation. Where practical, compiled Tolk BoCs are validated against the existing TypeScript Sandbox test suites.

Included

• Protocol contracts: config, elector, dns
• Wallets: w5.2, highload-v3.1, multisig-v2.1
• Tokens and assets: nft-v1.1, jetton-v2.1, jetton-v1.3
• Minimal example: counter

Each suite is organized as a self-contained package with contracts/, tests/, and scripts/. Selected suites also include benchmark baselines for regression tracking.

Included protocol contracts act as an example, how even the most complex contracts can be written with Acton. For now, they are not used in TON Mainnet.

Get started with Acton

Acton is a modern toolchain for TON smart contract development. It includes a native Tolk test runtime, an IDE-integrated debugger, dApp-ready templates, wallet management with testnet faucet support, and a scripting framework.

Install Acton:

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

Learn more in the Acton documentation.

If one wants to start the project with Jetton, NFT, W5 or Counter, it is recommended to start project from acton template.

acton new

This command will prompt interactively.

AI integrations

Acton and this monorepo are designed to work well with AI coding agents. Install the TON development skills:

npx skills add -g https://github.com/ton-blockchain/skills
# Or for a specific agent
# Codex
npx skills add -a codex https://github.com/ton-blockchain/skills

# Claude Code
npx skills add -a claude-code https://github.com/ton-blockchain/skills

Then ask your agent to complete an engineering task in this project:

"Optimize multisig-v2 gas usage. Use $acton and $tolk skills. Make gas snapshots and run benchmarks for comparison between different versions. Your optimizations should pass all current tests."

Wrappers

All WrapperName.gen.tolk wrappers in this monorepo are generated automatically and used for Tolk testing and scripting. Use acton wrapper ContractName to generate them.

To generate TypeScript wrappers:

acton wrapper --ts ContractName

Workflow

acton build
acton test
acton check
acton fmt --check

Run a single suite:

acton test dns/tests
acton test elector/tests
acton test multisig-v2.1/tests

Benchmarks

Each **/tests/benchmarks/*.json file is a gas snapshot baseline, that can be used to compare different implementations in terms of gas efficency. See **/tests/e2e-happy-paths.test.tolk for end-to-end tests, that are used as benchmark for gas measurements.

Using DNS set of contracts as example (replace DNS with desired contract-set folder):

Run a benchmark comparison against the checked-in DNS baseline:

acton test dns/tests/e2e-happy-paths.test.tolk --baseline-snapshot dns/tests/benchmarks/v1.json --fail-on-diff

Refresh the DNS benchmark snapshot:

acton test dns/tests/e2e-happy-paths.test.tolk --snapshot dns/tests/benchmarks/v1.json

Run a deployment script:

acton script dns/scripts/deploy.tolk
acton script w5.1/scripts/deploy.tolk

CI executes the same build, test, lint, and format pipeline on every change.