A development environment for TON blockchain for writing, testing, and deploying smart contracts.

Run the following in terminal to create a new project and follow the on-screen instructions:

npm create ton@latest

• Create a development environment from template in one click - npm create ton
• Streamlined workflow for building, testing and deploying smart contracts
• Dead simple deployment to mainnet/testnet using your favorite wallet (eg. Tonkeeper)
• Blazing fast testing of multiple smart contracts in an isolated blockchain running in-process

1. Compiling FunC with https://github.com/ton-community/func-js (no CLI)
2. Testing smart contracts with https://github.com/ton-community/sandbox
3. Deploying smart contracts with TON Connect 2, Tonhub wallet or a ton:https:// deeplink

• Node.js with a recent version like v18, verify version with node -v
• IDE with TypeScript and FunC support like Visual Studio Code with the FunC plugin

1. Run and follow the on-screen instructions:   npm create ton@latest   or   npx create-ton@latest
2. (Optional) Then from the project directory:   npm install   or   yarn install

• contracts/ - Source code in FunC for all smart contracts and their imports
• wrappers/ - TypeScript interface classes for all contracts (implementing Contract from ton-core)
  • include message [de]serialization primitives, getter wrappers and compilation functions
  • used by the test suite and client code to interact with the contracts from TypeScript
• tests/ - TypeScript test suite for all contracts (relying on Sandbox for in-process tests)
• scripts/ - Deployment scripts to mainnet/testnet and other scripts interacting with live contracts
• build/ - Compilation artifacts created here after running a build command

Note: Create a directory named imports under contracts and put stdlib.fc file to resolve any compilation errors due to required standard library funcation.

1. You need a compilation script in wrappers/<CONTRACT>.compile.ts - example
2. Interactive:   npx blueprint build   or   yarn blueprint build
3. Non-interactive:   npx/yarn blueprint build <CONTRACT>
   • Example: yarn blueprint build counter
4. Build results are generated in build/<CONTRACT>.compiled.json

1. Run in terminal:   npm test   or   yarn test

1. You need a deploy script in scripts/deploy<CONTRACT>.ts - example
2. Interactive:   npx blueprint run   or   yarn blueprint run
3. Non-interactive:   npx/yarn blueprint run <CONTRACT> --<NETWORK> --<DEPLOY_METHOD>
   • Example: yarn blueprint run deploycounter --mainnet --tonconnect

1. Make sure you have a project to host the contract
2. Interactive:   npx blueprint run   or   yarn blueprint create
3. Non-interactive:   npx/yarn blueprint create <CONTRACT> --type <TYPE> (type can be empty or counter)
   • Example: yarn blueprint create MyNewContract --type empty

1. Implement the standalone FunC root contract in contracts/<CONTRACT>.fc
2. Implement shared FunC imports (if breaking code to multiple files) in contracts/imports/*.fc
3. Implement wrapper TypeScript class in wrappers/<CONTRACT>.ts to encode messages and decode getters

1. Implement TypeScript tests in tests/<CONTRACT>.spec.ts
2. Rely on the wrapper TypeScript class from wrappers/<CONTRACT>.ts to interact with the contract

1. Implement a compilation script in wrappers/<CONTRACT>.compile.ts
2. Implement a deployment script in scripts/deploy<CONTRACT>.ts
3. Rely on the wrapper TypeScript class from wrappers/<CONTRACT>.ts to initialize the contract

MIT