Glossary

One-line definitions for terms used across the TON Connect spec. Entries link to the canonical page.

AppDomain — dApp domain bound into ton_proof and signData signatures. See spec/connect.md.

AppRequest — JSON-RPC-style envelope a dApp sends to a wallet. See spec/rpc.md.

Bridge — Transport carrying TON Connect messages between a dApp and a wallet; comes in HTTP and JS flavours. See spec/bridge.md.

BridgeMessage — Envelope the HTTP bridge writes onto the recipient's SSE stream. See spec/bridge.md.

Client keypair — X25519 nacl.box keypair each side generates per session. See spec/session.md.

client_id — 32-byte X25519 public key identifying one side of a session, hex-encoded for transport. See spec/session.md.

Connect event — Wallet's reply to a ConnectRequest: connect on success, connect_error on failure. See spec/connect.md.

Connect request — First message a dApp sends, delivered via deep link or QR code. See spec/connect.md.

ConnectItem — Data item the dApp asks the wallet to share at connect time (ton_addr, ton_proof). See spec/connect.md.

dApp — Decentralised application that integrates TON Connect. See spec/overview.md.

Deep link — URI form (tc://..., tonkeeper-tc://...) that opens a wallet on mobile. See spec/deeplinks.md.

deepLink — Optional wallets-list field carrying a wallet-specific custom-scheme link. See spec/wallets-list.md.

DeviceInfo — Wallet's self-description returned in the connect event. See spec/connect.md.

e parameter — Optional deep-link query parameter carrying an embedded request. See spec/deeplinks.md.

Embedded request — RPC request packed into the connect URL so the wallet handles connection and action in one tap. See spec/deeplinks.md.

EmbeddedWireRequest — Compact wire format for an embedded request, with abbreviated field names. See spec/deeplinks.md.

Feature flag — Entry in DeviceInfo.features advertising a wallet capability: SendTransaction, SignData, SignMessage, EmbeddedRequest. See spec/connect.md.

from — Optional sender address pinning the signing account on sendTransaction, signMessage, signData. See spec/rpc.md.

Heartbeat — Periodic SSE keep-alive emitted by the HTTP bridge. See spec/bridge.md.

HTTP bridge — Server-relayed, end-to-end-encrypted bridge transport. See spec/bridge.md.

id — Monotonically increasing identifier on AppRequest, WalletResponse and WalletEvent. See spec/rpc.md.

id parameter — Deep-link query parameter carrying the dApp's client_id as hex. See spec/deeplinks.md.

Item — Structured TonItem, JettonItem or NftItem in a sendTransaction or signMessage payload. See spec/rpc.md.

JS bridge — In-wallet browser transport on window.<walletJsBridgeKey>.tonconnect; plaintext, because the dApp and the wallet run on the same device. See spec/bridge.md.

last_event_id — Query parameter on GET /events for resuming an SSE stream. See spec/bridge.md.

Manifest (app) — JSON file the wallet fetches before the connect prompt; describes the dApp. See spec/manifest.md.

manifestUrl — HTTPS URL the dApp publishes in ConnectRequest. See spec/manifest.md.

maxProtocolVersion — Highest TON Connect protocol version the wallet supports; currently 2. See spec/connect.md.

NETWORK_ID — TON network global_id as a stringified integer carried on every network field; -239 (mainnet) and -3 (testnet) are the well-known values defined by the NETWORK enum, and any other valid TON network global_id is also a valid NETWORK_ID. See spec/connect.md.

Nonce — 24 fresh CSPRNG bytes prepended to each nacl.box ciphertext. See spec/session.md.

r parameter — Deep-link query parameter carrying the ConnectRequest as URL-safe JSON. See spec/deeplinks.md.

ret / return strategy — Deep-link query parameter telling the wallet where to send the user after signing. See spec/deeplinks.md.

Send mode 3 — TVM SENDRAWMSG mode PAY_GAS_SEPARATELY + IGNORE_ERRORS used by signMessage. See spec/rpc.md.

Session — The pair of client_ids identifying one dApp-wallet relationship. See spec/session.md.

SSE — Server-Sent Events; the streaming transport used by GET /events. See spec/bridge.md.

StateInit — Initial code-and-data cell for a TON contract, carried as walletStateInit in TonAddressItemReply or as Message.stateInit. See spec/connect.md.

tc:// — Unified deep-link scheme every wallet MUST support. See spec/deeplinks.md.

ton_addr — ConnectItem requesting the connected account's address, network, public key and walletStateInit. See spec/connect.md.

ton_proof — Signed message proving the user owns the connected wallet address. See spec/connect.md.

tondns — Optional wallets-list field naming the wallet's TON DNS entry; reserved. See spec/wallets-list.md.

topic — Optional POST /message parameter naming the RPC method for push routing. See spec/bridge.md.

trace_id — Optional UUID (UUIDv7 recommended) for analytics correlation, carried as a query parameter on bridge endpoints and connect links and echoed in the BridgeMessage envelope; tracing-unaware bridges MAY omit the field, and readers MUST tolerate its absence. See spec/bridge.md.

ttl — Required POST /message parameter — seconds the bridge buffers the message. See spec/bridge.md.

Universal link — Wallet-specific HTTPS link listed as universal_url in the wallets list. See spec/deeplinks.md.

v parameter — Deep-link query parameter naming the protocol version (currently 2). See spec/deeplinks.md.

valid_until — Optional payload field on sendTransaction and signMessage; unix seconds after which the wallet MUST reject. See spec/rpc.md.

Wallet — Application holding the user's keys and signing on their behalf. See guides/wallet-guidelines.md.

WalletEvent — Wallet-initiated message: connect, connect_error or disconnect. See spec/rpc.md.

WalletResponse — Wallet's reply to a specific AppRequest, matched by id. See spec/rpc.md.

walletStateInit — Base64-encoded StateInit cell in TonAddressItemReply, used to recover the public key. See spec/connect.md.

Wallets list — Public registry at ton-connect/wallets-list; served as wallets-v2.json. See spec/wallets-list.md.