Skip to main content

Deploying to network

Summary: In previous steps, we developed and tested our smart contract, ensuring its correctness.

In this part of the guide, we will proceed with the deployment of the previously developed smart contract and cover interaction with it on-chain.

Address and initial state​

We already know that address is a unique identifier of a smart contract on the network, used to send transactions and verify the sender upon receiving a message. However, we still haven't discussed how it's created. The common formula for a smart contract address looks like this:

address = hash(state_init(code, data))

The address of a smart contract is a hash of the aggregated initial code and data of the smart contract upon deployment. This simple mechanism has a few important consequences:

You already know the address​

In TON, any address that doesn't have any data is considered in the nonexist state. Nevertheless, when we created a wallet using the wallet app in the Getting started section, we were still able to get the address of our future wallet smart contract from the wallet app before its deployment and examine it in the explorer.

The reason behind this is that creating your private and public key pair through a mnemonic phrase, where the second key is part of the initial data of the smart contract, makes the state_init of our contract fully determined:

  • code is one of the standard wallet implementations, like v5r1.
  • data is the public_key along with other default initialized fields.

This makes it possible to calculate the future wallet smart contract address.

Magic storage member​

In previous steps, we deliberately didn't explain the purpose of id stored in our smart contract's state and why it remained untouched in all the smart contract functionality. Now, its purpose should start to become clearer.

Since we can't deploy a smart contract with the same state_init, the only way to provide the same initial code and "same" initial data is to create a separate field in it, ensuring additional uniqueness. This, in the case of a wallet, gives you the opportunity to have the same key pair for several wallet smart contracts.

One to rule them all​

If you've already considered that the id field is a must-have for any smart contract, there is another opportunity that could change your mind. Let's examine the previously developed HelloWorld smart contract's init section:

init(id: Int) {
    self.id = id;
    self.counter = 0;
}

If we remove the id field from its initial storage, we can ensure that only one HelloWorld smart contract can exist for a particular owner.

Tokens

This mechanism plays a crucial role in Jetton processing. Each non-native (jetton) token requires its own Jetton Wallet for a particular owner and, therefore, provides a calculable address for it, creating a star scheme with the basic wallet in the center.

Implementation​

Now that our smart contracts are fully tested, we are ready to deploy them to TON. In Blueprint, this process is the same for both Mainnet and Testnet and for any of the presented languages in the guide: FunC, Tact, or Tolk.

Step 1: update the deployment script​

Deployment scripts rely on the same wrappers that you have used in testing scripts. We will use one script to deploy the previously developed smart contract. Update deployHelloWorld.ts with this code:

/scripts/deployHelloWorld.ts
// @version TypeScript 5.8.3
import { toNano } from '@ton/core';
import { HelloWorld } from '../wrappers/HelloWorld';
import { NetworkProvider } from '@ton/blueprint';

export async function run(provider: NetworkProvider) {
    const sender = provider.sender();

    const helloWorld = provider.open(
        await HelloWorld.fromInit(0n)
    );

    await helloWorld.send(
        sender,
        { value: toNano('0.05') },
        null
    );

    await provider.waitForDeploy(helloWorld.address);

    console.log('ID', await helloWorld.getId());
}

Step 2: run deploy script​

You can run the script by entering the following command:

npx blueprint run deployHelloWorld

Step 3: choose network​

After that, you will see an interactive menu allowing you to choose a network:

? Which network do you want to use? (Use arrow keys)
  mainnet
❯ testnet
  custom
danger

Before deployment to the Mainnet, ensure that your smart contracts correspond to Security measures. As we said before, the HelloWorld smart contract doesn't.

Step 4: choose wallet app​

Next, choose the way to access your wallet. The easiest way to do that is using TON Connect for the most popular wallet apps: Tonkeeper, MyTonWallet, or Tonhub.

? Which wallet are you using? (Use arrow keys)
❯ TON Connect compatible mobile wallet (example: Tonkeeper)
  Create a ton:// deep link
  Mnemonic

? Choose your wallet (Use arrow keys)
❯ Tonkeeper
  MyTonWallet
  Tonhub

Finally, scan the QR code in the terminal through your wallet app and connect the wallet. After you've done that for the first time in the project, this step will be skipped.

You will receive a transaction request in your wallet app each time your code requires currency for a transaction.

Step 5: observe your smart contract on the network​

After confirming the request in your wallet and awaiting deployment, you will see a corresponding message with a reference to your newly deployed smart contract view in the explorer:

Contract deployed at address EQBrFHgzSwxVYBXjIYAM6g2RHbeFebJA8QUDwg4IX8CPDPug
You can view it at https://testnet.tonscan.org/address/EQBrFHgzSwxVYBXjIYAM6g2RHbeFebJA8QUDwg4IX8CPDPug

Congratulations! Your custom smart contract is ready to execute get methods the same way as your wallet in the Getting started section and execute transactions the same as in the Blockchain interaction section. Consider reading these sections to understand how to interact with smart contracts off-chain if you haven't already.

tip

Using Blueprint and wallet apps is not the only option. You can create a message with state_init by yourself. Moreover, you can do it even through a smart contract's internal message.

What’s next?​

You’ve made it through the guide — great job! Now, it’s time to dive deeper and keep building. Here are some helpful resources to continue your Tact journey:

Stay curious, build boldly, and don’t hesitate to ask questions — the Tact community is here for you!

Was this article useful?