The TAC SDK is a powerful JavaScript/TypeScript library that enables frontend developers to build hybrid dApps with unprecedented ease. By abstracting the complexities of cross-chain messaging, the SDK allows you to focus on creating exceptional user experiences while handling wallet connections, transaction routing, and asset bridging automatically.
The TAC SDK bridges the gap between TON’s massive user base and EVM’s rich DeFi ecosystem, enabling developers to create applications that leverage the best of both worlds.

​
Core Capabilities

The TAC SDK provides four essential capabilities that transform how developers approach cross-chain development:

​
Seamless Wallet Integration

Connect users with their existing TON wallets through the standard TON Connect protocol. No additional software installation or new seed phrases required. 
import { TacSdk, SenderFactory, Network, AssetType } from "@tonappchain/sdk";

// Initialize SDK and connect wallet
const tacSdk = await TacSdk.create({ network: Network.TESTNET });
const sender = await SenderFactory.getSender({ tonConnect: tonConnectUI });

​
Direct EVM Contract Interaction

Execute complex EVM contract calls directly from TON wallets. The SDK handles all cross-chain message formatting and routing automatically. 
// Call an EVM DEX directly from TON
const evmProxyMsg = {
  evmTargetAddress: "0x742d35Cc647332...",
  methodName: "swapExactTokensForTokens(bytes,bytes)",
  encodedParameters: encodedSwapData,
};

const result = await tacSdk.sendCrossChainTransaction(
  evmProxyMsg,
  sender,
  assets
);

​
Automatic Asset Bridging

Bridge TON, Jettons, and NFTs to EVM seamlessly. The SDK manages locking, minting, and unlocking across chains without manual intervention. 
// Bridge multiple assets in a single transaction
const assets = [
  {
    type: AssetType.FT,
    amount: 10.5,
  }, // Native TON
  {
    type: AssetType.FT,
    address: "EQJettonMasterAddress...",
    amount: 1000,
  }, // Jetton tokens
];

​
Real-Time Operation Tracking

Monitor cross-chain transactions with comprehensive status tracking. Get detailed progress updates and handle completion or failure scenarios gracefully. 
// Track transaction progress
const tracker = new OperationTracker(Network.TESTNET);
const operationId = await tracker.getOperationId(transactionLinker);
const status = await tracker.getOperationStatus(operationId);

​
How It Works

The TAC SDK acts as a bridge between your frontend application and TAC’s cross-chain infrastructure:

Message Preparation

Your application specifies the desired EVM operation using familiar JavaScript objects. The SDK validates parameters and encodes them for cross-chain delivery.

Asset Management

The SDK automatically handles asset locking on TON and prepares them for minting on the EVM side, managing all complex token mechanics.

Cross-Chain Routing

Messages are routed through TAC’s sequencer network, which validates operations and ensures secure cross-chain delivery.

EVM Execution

Your target EVM contracts receive properly formatted calls with bridged assets, executing exactly as if called from an EVM wallet.

Status Updates

The SDK provides real-time updates throughout the process, allowing your application to show users exactly what’s happening.

​
Developer Experience

The SDK is designed to feel familiar to web developers while providing powerful cross-chain capabilities:
Standard async/await patterns, Promise-based error handling, and conventional configuration objects make the SDK feel like any other JavaScript library.
  try {
  const transactionLinker = await tacSdk.sendCrossChainTransaction(message, sender, assets);
  const tracker = new OperationTracker(Network.TESTNET);
  await tacSdk.startTracking(transactionLinker, Network.TESTNET);
  const operationId = await tracker.getOperationId(transactionLinker);
} catch (error) {
  handleTransactionError(error);
}

​
Key Components

​
What’s Next?

Ready to start building hybrid dApps? The next sections will guide you through installation, configuration, and your first cross-chain transaction.

Installation Guide

Install and configure the TAC SDK in your application

Quick Start

Send your first cross-chain transaction in minutes
New to cross-chain development? Check out our Core Concepts section to understand the fundamentals of hybrid dApps and how TAC enables seamless cross-chain interactions.