Overview
Reference documentation for all Acton CLI commands
This section contains reference documentation for all Acton CLI commands.
Global Project Selection Flags
These global flags control how Acton selects project files and where it treats as project root:
--project-root <PATH>sets project root explicitly.--manifest-path <PATH>selects whichActon.tomlto load for config and does not change project root resolution.- Full resolution rules are documented in
Project Root Resolution.
Use --project-root when running commands from outside the project directory,
and you want project-relative outputs (for example .acton, wallets.toml,
test-results) to be written into that project.
# Run tests from a sibling directory as if you were in ../my-project
acton --project-root ../my-project test
# Load config from another manifest without changing project root resolution
acton --manifest-path ../my-project/Acton.toml wallet new --localGlobal Environment Overrides
Acton normally refreshes the bundled standard library in .acton/ before
commands that need project support, such as build, test, script, new,
and init.
Set ACTON_DISABLE_AUTO_STDLIB=1 to skip that automatic .acton/ refresh for
the current process. Explicit standard-library commands, such as
acton init --stdlib-only, still update .acton/.
Acton disables HTTP proxy detection by default for its own HTTP clients. This
means HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and system proxy settings are
ignored unless you opt in. The default avoids macOS sandbox crashes caused by
system proxy autodetection.
Set ACTON_USE_PROXY=1 or ACTON_USE_PROXY=true to let Acton use those proxy
settings for the current process.
Help And Manuals
Use the CLI help surfaces intentionally:
acton --helpshows the root overview and top-level command listacton help <command>opens the long manual for a top-level command- nested subcommands still use direct clap help such as
acton wallet list --help
When something about the local environment looks wrong, acton doctor is the
best troubleshooting entry point before you start digging into individual
command manuals.
Initialize Current Directory
Add an Acton scaffold to an existing directory without creating a new project folder
Creating projects
Learn how to initialize new Acton projects using the new command
Building Contracts
Compile configured contracts, emit artifacts, and inspect dependency outputs
Using Help and Manuals
Open root help, detailed command manuals, and pager-backed CLI reference docs
Managing Git Hooks
Scaffold project hooks, check Git hook status, and enable or disable
.githooks
Compiling Tolk smart contracts
Learn how to use the compile command to build Tolk source code into TVM bitcode
Generating Wrappers
Produce Tolk or TypeScript wrappers and optional test stubs from contract ABI
Formatting Tolk files
Learn how to use the fmt command to format .tolk files consistently
across your project or validate formatting in CI
Disassembling TVM bytecode
Learn how to use the disasm command to convert compiled TVM bytecode back to human-readable TASM instructions
Retracing transactions
Replay on-chain transactions locally to inspect VM phases, actions, and logs by hash
Documentation from CLI
Lookup instruction reference from the built-in TVM specification, including exact and fuzzy search modes
Running tests
Learn how to run Tolk smart contract tests using the test command
Checking Tolk contracts
Learn how to use the check command to lint Tolk contracts and files
Running Tolk scripts
Learn how to use the script command to execute standalone Tolk files for experimentation, deployment, and blockchain interaction
Running Named Scripts
Execute script entries declared in Acton.toml with pass-through
arguments
Verifying smart contract source code
Learn how to use the verify command to validate that deployed smart contracts match their source code
Managing Libraries
Learn how to use the library command to publish and fetch contract libraries
Managing Wallets
Learn how to create and manage testnet wallets for testing and deployment
Inspecting Remote State
Query account information from a network endpoint and decode storage with local ABI metadata when available
Local Development Node
Learn how to start local node, fork remote state, and fund addresses with built-in faucet
Language Server
Start the Acton language server over stdio or TCP for editor integrations
Managing Acton Versions
List, inspect, and install stable or trunk Acton releases
Inspecting Project Environment
Print resolved project, manifest, toolchain, and environment details for troubleshooting
Converting FunC to Tolk
Translate .fc and .func sources with the bundled conversion
workflow
Shell Completions
Learn how to enable autocompletion for the acton CLI in your shell
Last updated on