Get Started

This guide explains how to install the package, create a gasless wallet, and get your first account.

1. Install the Package

Prerequisites

Node.js: version 18 or higher.
npm: usually comes with Node.js.

Install @tetherto/wdk-wallet-ton-gasless

npm install @tetherto/wdk-wallet-ton-gasless

2. Create a Gasless Wallet

You can create a new gasless wallet instance using the WalletManagerTonGasless constructor with a BIP-39 seed phrase, TON client endpoints, and a paymaster token configuration:

Create Gasless TON Wallet

import WalletManagerTonGasless, {
  WalletAccountTonGasless,
  WalletAccountReadOnlyTonGasless
} from '@tetherto/wdk-wallet-ton-gasless'

const seedPhrase = 'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about'

const wallet = new WalletManagerTonGasless(seedPhrase, {
  tonClient: {
    url: 'https://toncenter.com/api/v3',
    secretKey: 'your-api-key' // Optional
  },
  tonApiClient: {
    url: 'https://tonapi.io/v2',
    secretKey: 'your-ton-api-key' // Optional
  },
  paymasterToken: {
    address: 'EQ...' // Paymaster Jetton master contract address
  },
  transferMaxFee: 10000000 // Optional: maximum fee in paymaster Jetton base units
})

Secure the Seed Phrase: You must securely store this seed phrase immediately. If it is lost, the user will permanently lose access to their funds.

3. Get Your First Account

You can retrieve an account at a given index using wallet.getAccount():

Get Account

const account = await wallet.getAccount(0)
const address = await account.getAddress()
console.log('Wallet address:', address)

4. (optional) Convert to Read-Only

You can convert an owned account to a read-only account using account.toReadOnlyAccount():

Convert to Read-Only

const readOnlyAccount = await account.toReadOnlyAccount()

Next Steps

With your wallet ready, learn how to manage multiple accounts.