Overview

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.

​

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(uint256,uint256,address[],address,uint256)",
  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:

​

Developer Experience

The SDK is designed to feel familiar to web developers while providing powerful cross-chain capabilities:

  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);
} 

  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);
} 

interface EvmProxyMsg {
  evmTargetAddress: string;
  methodName?: string;
  encodedParameters?: string;
  gasLimit?: bigint;
}

const evmProxyMsg: EvmProxyMsg = {
  evmTargetAddress: "0x742d35Cc647332...",
  methodName: "transfer(address,uint256)",
  encodedParameters: encodedTransferData
};

// Simulate before executing
const simulation = await tacSdk.getTransactionSimulationInfo(
  evmProxyMsg,
  sender,
  assets
);

if (simulation.success) {
  // Proceed with actual transaction
  const result = await tacSdk.sendCrossChainTransaction(evmProxyMsg, sender, assets);
}

​

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.