TON Blueprint is an open-source development environment for writing, testing and deploying smart contracts on the TON blockchain. It is aimed at developers who build TON-based applications and want a ready-made project template, a local test sandbox and a straightforward path to testnet and mainnet. The project is deprecated, and its maintainers point users to Acton instead. It no longer accepts pull requests, so treat this page as a guide to an existing toolkit rather than an actively developed product.
Blueprint is free and released under the MIT license, so you can read its source, adapt it and keep using it for existing projects. Its main value today is in learning TON development workflows and maintaining older Blueprint-based projects. Windows builds are expected, but confirm support on the releases page before you install.
What Is a TON Smart Contract Toolkit?
A smart contract is a program that lives on a blockchain and executes according to its code once a transaction triggers it. On the TON blockchain, developers write contracts, compile them into deployable code, test their behavior and then publish them to a network. Each of those steps needs tooling, and a toolkit like Blueprint bundles them so you do not have to assemble them by hand.
A toolkit also handles conventions. It decides where source files go, how tests are structured and how deployment scripts call a wallet. Those choices matter because a consistent project layout makes it easier for a second developer to pick up your work.
The key concept to understand is the difference between testnet and mainnet. Testnet is a practice network where tokens have no real value and mistakes cost nothing. Mainnet is the live network where deployments are permanent and transactions move real assets. A good toolkit makes it easy to move the same code between the two, but the discipline of testing first belongs to the developer.
Who Is This Kind of Workflow For?
Blueprint-style tooling fits several kinds of readers. A JavaScript or TypeScript developer who has built web applications may find the project structure familiar and can focus on contract logic rather than new language tooling. A developer moving to TON from an Ethereum background will recognize the general cycle of write, test and deploy, even though the chain itself works differently.
Freelancers and small teams are another natural audience. If you maintain an existing TON application, you may need to read, fix or extend a codebase created with Blueprint. Understanding the toolkit helps you make safe changes without rewriting everything.
Students and hobbyists can use the same environment to learn how contracts behave. Because tests run locally, you can experiment, break things and try again without paying for each attempt on a live network.
How Local Sandbox Testing Fits Into Contract Development
Testing is where most avoidable contract errors get caught. A local sandbox lets you deploy contracts to a simulated chain, send test messages and check the resulting state in seconds. You can script scenarios such as a user depositing funds, a second user withdrawing, and an administrator changing a setting, then confirm each outcome.
Isolated state is the important idea here. Each test starts from a known starting point, so a failure points to your code rather than to leftover data from an earlier run. That makes results repeatable, which is essential when you return to a project weeks later.
Sandbox testing does not replace testnet deployment. It can miss network-level behavior, wallet interactions and timing issues that appear only on a live network. The practical approach is to run the local suite first, deploy to testnet second and treat mainnet as the final step after both stages look right.
Key features
Project scaffolding
Build, test and deploy workflow
Deployment with your own wallet
Fast in-process testing
Supported coins
Blueprint is built for smart contracts on the TON blockchain. Its documented workflow covers deployment to both mainnet and testnet, and it works with wallets such as Tonkeeper. Check the project repository for the exact networks and tooling each release supports.
How to install TON Blueprint on Windows
- 1
Check your environment
Install Node.js with npm on your Windows PC before anything else. Blueprint is a command-line tool that runs through npm, so both must be available in your terminal. Open a new terminal window after installation so the commands are recognized.
- 2
Download from the official source
Download only from the official website or the project's GitHub Releases page at github.com/ton-org/blueprint. Avoid third-party mirrors and file-sharing sites, since they can distribute modified installers that look genuine.
- 3
Verify the file
Compare the SHA-256 checksum of the downloaded file with the value published alongside the release, or check the signature if one is provided. Do not run any file that fails the check, and delete it instead of trying to bypass the warning.
-
Create a project
Open a terminal in the folder where you want your project and run npm create ton@latest. Follow the prompts to generate the development environment from the official template, then open the new folder in your editor.
System requirements
- Windows PC with PowerShell or Command Prompt
- Node.js with npm, needed to run the npm create command
- Internet access to download the template and packages
How to use TON Blueprint
Once the environment is ready, the work follows the usual smart contract cycle. Each step below builds on the one before it, and skipping ahead is the most common way to lose money on mistakes that testing would have caught.
- Open the generated project folder in your editor and review the structure the template created.
- Write or edit your contract source files, keeping each contract focused on one clear responsibility.
- Run the test suite to check contract behavior in the in-process sandbox, and fix any failures before continuing.
- Deploy to testnet first using your wallet, such as Tonkeeper, and confirm each transaction in the wallet before signing.
- Deploy to mainnet only after testnet results match what you expected, and keep a record of the contract address and version.
Pros & cons
- Free and released under the MIT license
- Open source, so the code can be read, audited and adapted
- Quick project setup with one npm command
- Testing runs in-process without an external node
- Deployment works with a familiar wallet such as Tonkeeper
- Written in JavaScript and TypeScript, which many web developers already know
- The project is deprecated and no longer accepts pull requests
- Acton is the recommended successor for new work
- Requires Node.js and comfort with the command line
- Windows builds are expected but not guaranteed for every release
- Support depends on GitHub issues rather than a guaranteed service
Is TON Blueprint safe?
TON Blueprint is deprecated, so it receives no new features or pull request reviews, and you should not assume that every security issue will be fixed quickly. For new projects, evaluate the successor, Acton, before starting. Download only from the official website or GitHub Releases, and verify the SHA-256 checksum or signature before running the installer. Never enter a seed phrase on a third-party website, and never share it with anyone who asks for it. Because Blueprint deploys contracts through your wallet, test on testnet first, read every transaction before signing and keep your seed phrase offline. Check the latest version on the official website before installing.
- Official source only. Download from github.com/ton-org/blueprint. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Blueprint is specific to TON, while the other tools in this category target different chains. Foundry is a toolkit for Ethereum-style contracts and includes forge, cast and anvil. Anchor is a framework for building Solana programs. Remix Desktop is an IDE for Solidity, which suits readers who prefer a graphical editor. Tenderly CLI focuses on debugging and monitoring contracts after they are deployed. If your work is on TON and you write in TypeScript, Blueprint's sandboxed workflow is the closest match. For new long-term projects on TON, however, consider Acton as the maintained successor.
Specifications
- Price
- Free
- Type
- Open source
- License
- MIT
- Latest version
- v0.47.1
- Last update
- 29 Sept 2026
- Windows support
- Likely (builds for Windows; check releases)
- Source code
- github.com/ton-org/blueprint
Frequently asked questions
No, the project is deprecated and its maintainers recommend Acton instead. It no longer accepts pull requests, so bug reports and questions go through GitHub issues. The code remains available under the MIT license, which means you can keep using it for existing work. For new projects, most readers should start with the successor.
It can be, if you download it only from the official website or GitHub Releases and verify the file. Compare the SHA-256 checksum or check the signature before running anything. Never enter your seed phrase on a third-party site. Because the project is deprecated, weigh the security risk of unmaintained code against your project's needs.
Install Node.js with npm first, then open a terminal in the folder where you want your project. Run the command npm create ton@latest and follow the prompts. The command generates a development environment from the official template, which you can then open in your editor and start working with.
Yes, Blueprint supports deployment to both mainnet and testnet using a wallet such as Tonkeeper. Mainnet transactions are permanent and involve real assets, so always test on testnet first. Read each transaction in your wallet carefully before approving it, and confirm the contract address after deployment.
Yes, the program is free and released under the MIT license. That license allows you to use, modify and redistribute the code within its terms. Being free does not remove other costs, such as network fees on TON and your own development time, so budget for those when you plan a project.
The recommended successor is Acton, which the project's maintainers point users toward. Choose it for new TON work, and keep Blueprint only for maintaining existing projects. If you work with other chains, compare Foundry for Ethereum-style contracts or Anchor for Solana, since each targets a different ecosystem.
Yes, because the setup command runs through npm, which comes with Node.js. Install Node.js before running the create command, then open a new terminal window so your system recognizes the tools. Node.js is needed for this command-line workflow, not as a separate runtime for the finished contracts.
Verdict
TON Blueprint suits developers who already work in TypeScript, want to learn TON workflows or maintain an existing Blueprint project. It is free, open source and quick to set up with one npm command, and its in-process testing makes iteration fast. It is not the best starting point for a new long-term project, because the project is deprecated and Acton is the recommended successor. Use it to learn or maintain, and move to the successor for fresh development.