Initialize TON wallets with TonWeb JavaScript SDK. Deploy v4R2 wallet contracts, generate key pairs, and automate wallet deployment with Chainstack nodes.
TLDR:
Explains the NFT standard on TON (TEP-62, TEP-64) and key features for ownership and metadata.
Demonstrates how to set up, compile, and deploy both NFT item and collection contracts.
Shows how to interact with these contracts via Blueprint wrappers and test them using Sandbox.
Provides a starting reference to extend NFT functionality on the TON blockchain.
Main article
To be able to use your account on TON, you need to have an initialized wallet. Wallet initialization means deploying a TON wallet contract for your account.While this is a great feature of the TON blockchain, you might find it cumbersome dealing with wallet deployments during your development stage.So here’s a couple of scripts in JavaScript using tonweb that can help you:
GenerateAndInitialize.js — a script that generates a key pair for an account and then keeps running until you top it up with TON; once the account has enough TON, the script deploys a wallet contract.
CheckAndDepoy.js — a script that checks whether an account is initialized; if it’s not initialized, the script deploys a wallet contract.
Start for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.
GenerateAndInitialize
This script does the following:
Generates a key pair and saves it to wallet_keys.json
Keeps running and checking the balance of the generated account until it’s topped up
Once the account is topped up, the script deploys a v4R2 wallet contract
const TonWeb = require('tonweb');const fs = require('fs');const httpProvider = new TonWeb.HttpProvider('CHAINSTACK_NODE_WITH_jsonRPC');const tonweb = new TonWeb(httpProvider);async function generateAndInitializeWallet() { // Generate a new key pair const keyPair = TonWeb.utils.nacl.sign.keyPair(); // Create a v4R2 wallet instance const WalletClass = tonweb.wallet.all['v4R2']; const wallet = new WalletClass(tonweb.provider, { publicKey: keyPair.publicKey, wc: 0 }); // Get the wallet address const walletAddress = await wallet.getAddress(); const addressString = walletAddress.toString(true, true, true); console.log('Generated wallet address:', addressString); console.log('Please send some TON to this address to initialize the wallet.'); // Save the key pair to a file const keyPairData = { publicKey: TonWeb.utils.bytesToHex(keyPair.publicKey), secretKey: TonWeb.utils.bytesToHex(keyPair.secretKey) }; fs.writeFileSync('wallet_keys.json', JSON.stringify(keyPairData, null, 2)); console.log('Key pair saved to wallet_keys.json'); // Wait for the wallet to be topped up await waitForBalance(walletAddress); // Initialize the wallet console.log('Initializing wallet...'); const deployResult = await wallet.deploy(keyPair.secretKey).send(); console.log('Deployment transaction sent:', deployResult); console.log('Waiting for deployment to complete...'); await new Promise(resolve => setTimeout(resolve, 10000)); // Wait for 10 seconds const seqno = await wallet.methods.seqno().call(); if (seqno !== null) { console.log('Wallet successfully initialized!'); } else { console.log('Wallet initialization might have failed. Please check the address on a block explorer.'); }}async function waitForBalance(address) { while (true) { const balance = await tonweb.getBalance(address); if (balance && balance !== '0') { console.log('Balance detected:', TonWeb.utils.fromNano(balance), 'TON'); break; } await new Promise(resolve => setTimeout(resolve, 5000)); // Check every 5 seconds }}generateAndInitializeWallet().catch(console.error);
Make sure you put your Chainstack TON node endpoint with a /jsonRPC at the end instead of CHAINSTACK_NODE_WITH_jsonRPC.
CheckAndDepoy
This script does the following:
Converts the private key to an account address
Checks the account if it’s initialized or not
Checks the balance
If the account is not initialized and has enough TON coins for wallet contract deployment, proceeds with the deployment
Make sure you put your Chainstack TON node endpoint with a /jsonRPC at the end instead of CHAINSTACK_NODE_WITH_jsonRPC; and put your private key inPRIVATE_KEY.
About the author
Ake
Director of Developer Experience @ Chainstack
Talk to me all things Web3
20 years in technology | 8+ years in Web3 full time years experience