Localnet
Overview
Run a TON-compatible local node with faucet, fork mode, startup wallets, and snapshot workflows
Acton includes a built-in local development node available through acton localnet.
It is designed for fast local iteration with a familiar TonCenter API and reproducible state workflows.
Why Use It
- Fast local feedback loop for deploys, transactions, and get-method calls.
- Optional fork mode for querying real blockchain state from testnet or mainnet.
- Built-in faucet and startup wallet bootstrap for zero-friction local testing.
- Reproducible environments with SQLite persistence or JSON snapshots.
Built-in Explorer UI
The local node serves a bundled explorer UI from the same HTTP server as the API.
- The root path redirects into the explorer UI, and client-side routes such as
/explorer,/tokens,/nfts,/explorer/address/<ADDR>, and/explorer/tx/<HASH>all resolve through the same single-page app shell. - The UI reads blockchain data from
/api/v2and/api/v3, and uses/admin/address-nameplus/admin/compiler-abifor local alias and ABI lookups.
Learn more
Getting Started
Start the node, send your first airdrop, and verify that the API is available.
Forking from Network
Use testnet or mainnet state locally, including historical forks at a specific block.
Startup Accounts
Auto-fund and auto-deploy configured wallets on node startup.
Persistence and Snapshots
Persist state to SQLite or export/import JSON snapshots for repeatable runs.
API Compatibility
Use TonCenter-compatible v2/v3 routes and admin endpoints.
Last updated on