Send Encrypted Message

Send a TON transfer with an end-to-end encrypted comment and decrypt it on the receiving side.

This example shows how to send a TON transfer with an encrypted comment. The comment is encrypted end-to-end (ECDH) so that only the sender and the intended recipient can read it.

Encrypt and Send

Pass encrypt=True to transfer(). The recipient’s public key is fetched from its wallet via the get_public_key get-method; for an undeployed recipient, pass it as recipient_public_key.

from ton_core import Address, NetworkGlobalID, to_nano

from tonutils.clients import ToncenterClient
from tonutils.contracts import WalletV4R2

# Mnemonic phrase
MNEMONIC = "word1 word2 word3 ..."

# Destination address (recipient)
DESTINATION_ADDRESS = Address("UQ...")


async def main() -> None:
    client = ToncenterClient(network=NetworkGlobalID.MAINNET)
    await client.connect()

    wallet, _, _, _ = WalletV4R2.from_mnemonic(client, MNEMONIC)

    # Send TON with a comment encrypted end-to-end (ECDH) for the recipient
    msg = await wallet.transfer(
        destination=DESTINATION_ADDRESS,
        amount=to_nano(0.01),
        body="Hello from tonutils!",
        encrypt=True,
    )

    # Normalized hash of the signed external message (computed locally) —
    # not the on-chain transaction hash
    print(f"Transaction hash: {msg.normalized_hash}")

    await client.close()


if __name__ == "__main__":
    import asyncio

    asyncio.run(main())

Decrypt

Use TextCipher.decrypt with the recipient’s private key and the original sender’s address. The encrypted payload (message body with opcode 0x2167DA4B) can be provided as raw bytes, a hex string, a base64 string, or a full body Cell parsed from BoC.

from ton_core import Address, NetworkGlobalID, TextCipher

from tonutils.clients import ToncenterClient
from tonutils.contracts import WalletV4R2

# Recipient's mnemonic phrase
MNEMONIC = "word1 word2 word3 ..."

# Original sender's address (used for verification)
SENDER_ADDRESS = Address("UQ...")

# Encrypted payload extracted from the transaction body
ENCRYPTED_PAYLOAD = "<encrypted payload>"


async def main() -> None:
    client = ToncenterClient(network=NetworkGlobalID.MAINNET)

    # Keep private_key for decryption as our_private_key
    _, _, our_private_key, _ = WalletV4R2.from_mnemonic(client, MNEMONIC)

    decrypted_comment = TextCipher.decrypt(
        payload=ENCRYPTED_PAYLOAD,
        sender_address=SENDER_ADDRESS,
        our_private_key=our_private_key,
    )

    print(f"Decrypted message: {decrypted_comment}")


if __name__ == "__main__":
    import asyncio

    asyncio.run(main())

The same example also appears in Encrypted Messages among the other wallet operations.