Skip to main content

Mint your first Jetton

Welcome, dev! It's great to have you here. ๐Ÿ‘‹

In this article, we'll tell you about creating your first fungible token (Jetton) on TON.

To mint Jettons we will be using the TON Minter / TON Minter testnet browser service.

๐Ÿ“– What you'll learnโ€‹

In this article, you'll learn how to:

  • deploy a Jetton using your browser
  • customize your token
  • manage and use your token
  • edit the token parameters

๐Ÿ“Œ Prepare before you startโ€‹

  1. First you need to have the Tonhub / Tonkeeper wallet or any other supported on the service.
  2. You must have more than 0.25 Toncoin on your balance plus additional funds to cover the blockchain commission.
Starter tip

~0.5 TON should be enough for this tutorial.

๐Ÿš€ Let's get started!โ€‹

Use your web browser to open the service TON Minter / TON Minter testnet.

image

Deploy a Jetton using your browserโ€‹

Connect Walletโ€‹

Click the Connect Wallet button to connect your Tonhub wallet or another wallet from the ones below.

imageโ€‹

Scan the QR-code in a Mobile wallet (Tonhub e.g.)

Fill in the blanks with relevant informationโ€‹

  1. Name (usually 1-3 words).
  2. Symbol (usually 3-5 uppercase characters).
  3. Amount (for example, 1,000,000).
  4. Description of the token (optional).

Token logo URL (optional)โ€‹

image

If you want to have an attractive Jetton token, you need to host a beautiful logo somewhere. For example:

info

You can easily find out about url placement of the logo in the repository in paragraph "Where is this metadata stored".

  • On-chain.
  • Off-chain IPFS.
  • Off-chain website.

How to create your logo URL?โ€‹

  1. Prepare a 256x256 PNG image of the token logo with a transparent background.
  2. Get a link to your logo. A good solution is GitHub Pages. Let's use them.
  3. Create a new public repository with the name website.
  4. Upload your prepared image to git and enable GitHub Pages.
    1. Add GitHub Pages to your repository.
    2. Upload your image and get a link.
  5. If you have your own domain, then it would be good to use .org instead of github.io.

๐Ÿ’ธ Send Jettonsโ€‹

On the right side of the screen, you can send tokens to multi-currency wallets such as Tonkeeper or Tonhub.

image

info

You always also burn your Jettons to reduce their amount.

image

๐Ÿ“ฑ Send tokens from phone using Tonkeeperโ€‹

Prerequisites:

  1. You must already have tokens on your balance to send them.
  2. There must be at least 0.1 Toncoin to pay transaction fees.

Step-by-step guideโ€‹

Then, go to your token, set the amount to send, and enter the recipient address.

image

๐Ÿ“š Using the token on the siteโ€‹

You can access the search field at the top of the site by entering the token's address to manage it as the owner.

info

The address can be found on the right side if you are already in the owner panel, or you can find the token address when receiving an airdrop.

image

โœ๏ธ Jetton (token) customizationโ€‹

With the FunC language you can change the behavior of the token in your favor.

To make any changes, begin here:

Step-by-step guide for developersโ€‹

  1. Make sure you have all "Dependencies and Requirements" from the tonstarter-contracts repo.
  2. Clone the minter-contract repository and rename the project.
  3. To install you need to open a terminal at the root and run:
npm install

  1. Edit the original smart contract files same way in the root terminal. All contract files are in contracts/*.fc

  2. Build a project by using:

npm run build

The build result will be describes the process of creating the necessary files, as well as the search for smart contracts.

info

Read the console, there are a lot of tips!

  1. You can test your changes by using:
npm run test
  1. Edit the name and other metadata of the token in build/jetton-minter.deploy.ts by changing JettonParams object.
// This is example data - Modify these params for your own jetton!
// - Data is stored on-chain (except for the image data itself)
// - Owner should usually be the deploying wallet's address.
  
const jettonParams = {
 owner: Address.parse("EQD4gS-Nj2Gjr2FYtg-s3fXUvjzKbzHGZ5_1Xe_V0-GCp0p2"),
 name: "MyJetton",
 symbol: "JET1",
 image: "https://www.linkpicture.com/q/download_183.png", // Image url
 description: "My jetton",
};
  1. To deploy a token use the following command:
npm run deploy

The result of running your project:

> @ton-defi.org/jetton-deployer-contracts@0.0.2 deploy
> ts-node ./build/_deploy.ts

=================================================================
Deploy script running, let's find some contracts to deploy..

* We are working with 'mainnet'

* Config file '.env' found and will be used for deployment!
 - Wallet address used to deploy from is: YOUR-ADDRESS
 - Wallet balance is YOUR-BALANCE TON, which will be used for gas

* Found root contract 'build/jetton-minter.deploy.ts - let's deploy it':
 - Based on your init code+data, your new contract address is: YOUR-ADDRESS
 - Let's deploy the contract on-chain..
 - Deploy transaction sent successfully
 - Block explorer link: https://tonwhales.com/explorer/address/YOUR-ADDRESS
 - Waiting up to 20 seconds to check if the contract was actually deployed..
 - SUCCESS! Contract deployed successfully to address: YOUR-ADDRESS
 - New contract balance is now YOUR-BALANCE TON, make sure it has enough to pay rent
 - Running a post deployment test:
{
  name: 'MyJetton',
  description: 'My jetton',
  image: 'https://www.linkpicture.com/q/download_183.png',
  symbol: 'JET1'
}

What's next?โ€‹

If you want to go deeper, read this article by Tal Kol:

Referencesโ€‹