Sign TON Messages

Learn how to sign messages using Dynamic’s Node SDK for TON

Overview

This guide shows you how to sign messages with your TON wallet. Message signing uses Ed25519 and returns the signature as a base64 string. It is commonly used for authentication, nonce verification, and data integrity checks.

Prerequisites

• Created a TON wallet

Basic Message Signing

import { authenticatedTonClient } from './client';

const tonClient = await authenticatedTonClient();

const signature = await tonClient.signMessage({
  message: 'Hello, TON!',
  walletMetadata,
});

console.log('Message signed (base64):', signature);

Simple Message Signing

Whether you need to provide externalServerKeyShares depends on how you created your wallet:

With Automatic Backup (Recommended)

If you created your wallet with backUpToDynamic: true, you don’t need to provide external key shares:

// ✅ Simple signing - no externalServerKeyShares needed
const signature = await tonClient.signMessage({
  message: 'Hello, TON!',
  walletMetadata,
});

console.log('Message signed (base64):', signature);

With Manual Backup

If you created your wallet with backUpToDynamic: false, you must provide external key shares:

// First, retrieve your stored key shares
const keyShares = await retrieveStoredKeyShares('YourTonWalletAddress');

// ❌ Must provide externalServerKeyShares
const signature = await tonClient.signMessage({
  message: 'Hello, TON!',
  walletMetadata,
  externalServerKeyShares: keyShares, // Required for manual backup!
  password: 'your-password', // Only if wallet was created with password
});

console.log('Message signed (base64):', signature);

Password Handling Notes:

• If your wallet was created without a password, omit the password parameter
• If your wallet was created with a password, you must provide it for all operations
• The password parameter is always optional in the API, but required if the wallet is password-protected

Common Use Cases

Authentication

const nonce = Date.now().toString();
const message = `Sign this message to authenticate: ${nonce}`;
const signature = await tonClient.signMessage({
  message,
  walletMetadata,
});
// signature is a base64-encoded Ed25519 signature

Data Integrity

const data = { userId: 123, action: 'transfer', amount: '100' };
const message = JSON.stringify(data);
const signature = await tonClient.signMessage({
  message,
  walletMetadata,
});

Next Steps

• Sign TON transactions