This project includes a set of examples for common use cases in Tact and consists of:
- Smart contracts written in the Tact language.
- A TypeScript + Jest testing environment with
@ton/sandbox. - Examples of off-chain and on-chain integrations with Jettons. Other TEPs are planned too.
If you're new to TON and Tact, please check https://docs.tact-lang.org/
The jettons folder consists of examples of common actions with Jettons in Tact.
Each folder inside it includes examples for one or more of the following:
*.tact- Smart contracts written in Tact that run on-chain and need to be deployed. Useyarn buildto compile them.*.spec.ts- TypeScript test files that validate the logic of the smart contracts. These tests also serve as examples of how to interact with smart contracts off-chain. Useyarn testto run them.*.ts- Scripts that perform actions on the blockchain. Useyarn ts-node filenameto execute them.
Jettons
Receive and verify incoming Jettons
This example demonstrates how to receive and verify incoming Jettons. It can be extended to support any custom Jetton implementation and handle additional logic after receiving funds.
Send Jettons from your contract
This example shows how to send Jettons from a contract. It includes both basic and extended modes for sending Jettons, allowing for custom payloads and additional parameters.
This example provides tools to mint USDT Jettons on the testnet. It includes a terminal script for deploying a Jetton minter and minting Jettons, as well as a Telegram bot that generates QR codes for minting transactions.
This example demonstrates how to interact with Jetton contracts on-chain. It includes fetching Jetton wallet addresses and balances directly from the blockchain, showcasing how to integrate on-chain data into your applications.
This example focuses on sending USDT (Governance) Jettons. It is very much like Send Jettons example, but with slightly different message structures. It supports both basic and extended modes for sending Jettons.
This example illustrates how to receive USDT Jettons and verify incoming transfer notifications. It is tailored for governance Jettons and includes logic for handling governance-specific state initialization.
If a given example is missing, please send us a PR to add it! Our aim is to have every example available in every option. We'd also love to see more contracts involving staking, wrapped tokens, oracles, DEXs and other TEPs. Please first create an issue for all new examples
This project is licensed under the MIT License.