Welcome to the TAC SDK guide for frontend developers. This section will help you create powerful, user-friendly interfaces that connect EVM contracts with TON wallets through the TON Adapter.

The TAC SDK makes it possible to create hybrid dApps that let TON users interact directly with EVM smart contracts without needing to manage multiple wallets or understand the complexities of cross-chain messaging.

What You Can Build with the TAC SDK

The TAC SDK enables you to create frontends that:

  • Connect to TON wallets like Tonkeeper or Tonhub
  • Send transactions from TON to your EVM contracts
  • Track cross-chain transaction status in real-time
  • Handle tokens across both chains
  • Create a seamless user experience for TON users

Key Components of the TAC SDK

Wallet Connections

Connect to TON wallets using TON Connect protocol and manage user sessions

Transaction Creation

Build and send cross-chain messages to your EVM contracts

Status Tracking

Monitor the status of cross-chain transactions as they progress

Asset Management

Handle token transfers between TON and TAC EVM chains

Frontend Integration Flow

When building a frontend with the TAC SDK, you’ll typically follow this workflow:

1

Set Up Your Project

Install and configure the TAC SDK in your JavaScript/TypeScript project
2

Connect to TON Wallets

Implement TON wallet connections using TON Connect
3

Create Cross-Chain Messages

Build messages that target your EVM contracts through the TON Adapter
4

Send and Track Transactions

Send transactions and implement status tracking for a responsive UI
5

Handle Assets

Manage token transfers and approvals across chains

The User Experience

From a user’s perspective, the experience is seamless:

  1. Connect Wallet: User connects their TON wallet (no EVM wallet needed)
  2. Interact with UI: User interacts with your dApp interface
  3. Approve Transaction: User approves a transaction in their TON wallet
  4. Wait for Processing: UI shows transaction status as it processes through both chains
  5. View Results: User sees the results of their interaction with your EVM contract
  6. All the cross-chain complexity is handled behind the scenes by the TAC SDK and TON Adapter.