Skip to main content

Documentation 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 wallet is your all-in-one interface for managing the cryptographic identities that power every Acton deployment, script, and verification flow. It handles the full lifecycle: generating fresh mnemonics, importing existing ones, querying on-chain balances, requesting faucet funds, signing external message bodies, exporting secrets, and cleaning up stale entries. Wallets are stored either locally in the current project’s wallets.toml or globally in global.wallets.toml, and Acton merges both at runtime — local entries always win when the same name appears in both files.
Wallets created with Acton are intended for development and testing. Never commit wallets.toml files containing real mnemonics to version control, and always use separate wallets for testnet and mainnet to avoid accidental fund loss.

​
Synopsis

acton wallet <SUBCOMMAND> [OPTIONS]

​
Subcommands

SubcommandDescription
newGenerate a new wallet and mnemonic
importImport an existing mnemonic-based wallet
listList all configured wallets
airdropRequest faucet funds for a wallet
export-mnemonicInteractively export a wallet mnemonic
signSign an external message body
removeRemove a wallet from configuration

​
acton wallet new

Generate a brand-new wallet with a fresh mnemonic. Acton prompts for any missing required values interactively. Synopsis 
acton wallet new [OPTIONS]
Options
FlagTypeDefaultDescription
--namestringpromptedWallet name (lowercased, spaces become -)
--versionenumpromptedWallet contract version (see values below)
--localflag—Save to project-local wallets.toml
--globalflag—Save to global.wallets.toml
--airdropflag—Request testnet TON immediately after creation
--faucet-urlURL—Custom faucet URL for the testnet airdrop
--no-wait-airdropflag—Skip the post-airdrop balance confirmation wait
--secureboolautoForce (true) or disable (false) keyring storage
--jsonflag—Emit JSON output
Wallet versions: v1r1, v1r2, v1r3, v2r1, v2r2, v3r1, v3r2, v4r1, v4r2, v5r1, highloadv1r1, highloadv1r2, highloadv2, highloadv2r1, highloadv2r2
For most deployment workflows, v5r1 is the recommended modern wallet version. v4r2 is also widely supported by ecosystem tooling.

​
acton wallet import

Import a wallet from an existing mnemonic. All storage options from wallet new apply here too. Synopsis 
acton wallet import [OPTIONS] [MNEMONIC_WORDS...]
Options
FlagTypeDefaultDescription
--namestringpromptedWallet name
--versionenumpromptedWallet contract version
--localflag—Save to project-local wallets.toml
--globalflag—Save to global.wallets.toml
--secureboolautoForce or disable keyring storage
--jsonflag—Emit JSON output

​
acton wallet list

List all configured wallets merged from global and local sources. Add --balance to query on-chain balances via TonCenter. Synopsis 
acton wallet list [OPTIONS]
Options
FlagTypeDefaultDescription
-b, --balanceflag—Fetch and print on-chain balances
--jsonflag—Emit JSON output
Balance lookups read TONCENTER_TESTNET_API_KEY from the environment (or .env). Set this key to avoid rate-limit errors on repeated balance checks.

​
acton wallet airdrop

Request faucet funds for a wallet. Works against the testnet PoW faucet or a running localnet. Synopsis 
acton wallet airdrop [NAME] [OPTIONS]
Options
FlagTypeDefaultDescription
--netenumtestnetAirdrop backend: testnet or localnet
--faucet-urlURL—Custom faucet URL (testnet only)
--no-wait-airdropflag—Skip balance confirmation wait
--jsonflag—Emit JSON output

​
acton wallet export-mnemonic

Interactively export a wallet’s mnemonic phrase. This command is intentionally interactive-only and asks for confirmation before revealing the secret. Synopsis 
acton wallet export-mnemonic [NAME]

​
acton wallet sign

Sign an external message body BoC using the selected wallet’s private key. Useful for tooling integrations that compose messages outside of Acton scripts. Synopsis 
acton wallet sign [NAME] [OPTIONS]
Options
FlagTypeDefaultDescription
--body, --messageBoC (hex/base64)stdin or promptedExternal body to sign
--jsonflag—Output signed BoC as JSON object

​
acton wallet remove

Remove a wallet entry from configuration. If the wallet uses keyring storage, Acton also removes the mnemonic from the secure store. Synopsis 
acton wallet remove [NAME] [OPTIONS]
Options
FlagTypeDefaultDescription
-y, --yesflag—Skip confirmation prompt
--jsonflag—Emit JSON output

​
wallets.toml Structure

Wallets are stored in TOML format. Acton supports four mnemonic sources, resolved in this priority order: mnemonic-env → mnemonic-file → mnemonic-keyring → mnemonic. 
[wallets.deployer]
kind = "v5r1"
workchain = 0
keys = { mnemonic-keyring = "my-project:deployer" }

[wallets.deployer.expected]
address-testnet = "0QD36XRy1ISfSB8zmlSQKBsa5bmeixAWwD6vUUhOXXur8ZLd"

​
Resolution Rules

  • Global wallets in global.wallets.toml are loaded first; local wallets.toml entries override them when names collide.
  • Commands that need a wallet auto-select it only when exactly one merged wallet is available.
  • On a TTY with multiple wallets, Acton prompts interactively. In non-interactive contexts, pass the wallet name explicitly.

​
Examples

acton wallet new --name deployer --version v5r1 --local

​
Security Notes

Plain-text mnemonic storage (mnemonic = "...") is only acceptable for throw-away development wallets. For any wallet that holds or will hold real funds, use mnemonic-keyring, mnemonic-env, or mnemonic-file instead. Acton adds wallets.toml to .gitignore automatically, but safe secret hygiene remains your responsibility.
  • Use --secure true to require keyring storage and fail fast if it is unavailable.
  • Use separate wallets for testnet and mainnet — never reuse the same mnemonic across networks.
  • The expected.address-testnet and expected.address-mainnet fields in wallets.toml act as safety checks; Acton validates the derived address before any real-network operation.

​
See Also

Build docs developers (and LLMs) love

Get started for freeTalk to us